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« 1. 0. 0 INTRODUCTION. 


# 1 . 0 . 0 


THIS MANUAL DESCRIBES ONE OF THE X8 (CROSS EIGHT) SERIES OF MICRO¬ 
PROCESSOR CROSS-ASSEMBLERS SIERRA DIGITAL SYSTEMS HAS DEVELOPED FOR 
PDP8 USERS. THE X3 SERIES WILL HANDLE ALL OF THE POPULAR MICRO¬ 
PROCESSORS WITHIN A UNIVERSAL ASSEMBLER FORMAT. THIS COMMON BASE 
OF ASSEMBLER DIRECTIVES AND TECHNIQUES IS A SELECTED COMBINATION OF 
DESIRABLE FEATURES OBSERVED IN A SURVEY OF MANY EXISTING MINI¬ 
COMPUTER AND MICROPROCESSOR ASSEMBLERS. THE INSTRUCTION MNEMONICS 
AND ASSOCIATED SYNTAX OF EACH PARTICULAR MICROPROCESSOR ARE 
RETAINED UNCHANGED. 

THIS MANUAL DESCRIBES THE USAGE OF ONE OF THE MICROPROCESSOR CROSS- 
ASSEMBLERS FROM THE SIERRA DIGITAL X8 SERIES. IN ORDER TO SIMPLIFY 
THE LEARNING PROCESS FOR INDIVIDUALS USING MORE THAN ONE CROSS- 
ASSEMBLER FROM THE SERIES, THIS MANUAL HAS BEEN DIVIDED INTO TWO 
MAJOR PARTS. SECTIONS 1 THROUGH 11 DOCUMENT THE UNIVERSAL ASSEMBLER 
FORMAT AS IT APPLIES TO ALL CROSS-ASSEMBLERS IN THE SERIES. THESE 
SECTIONS WILL BE IDENTICAL IN EVERY CROSS-ASSEMBLER MANUAL. 
SECTION 12 PRESENTS INFORMATION ON APPLICATION OF THE UNIVERSAL 
ASSEMBLER FORMAT TO THE SPECIFIC MICROPROCESSOR CROSS-ASSEMBLER. 
SECTION 13 PRESENTS A SUMMARY OF THE MNEMONIC INSTRUCTION CODES 
ASSIGNED BY THE MICROPROCESSOR VENDOR AND RECONIZED BY THE CROSS- 
ASSEMBLER. NO ATTEMPT HAS BEEN MADE TO DESCRIBE THE OPERATION OF 
THE MICROPROCESSOR ITSELF. SUCH INFORMATION MUST BE OBTAINED FROM 
THE MICROPROCESSOR VENDOR OR OTHER SOURCES. SECTION 14, THE APPEN¬ 
DICES, CONTAINS SUMMARY TABLES FOR QUICK REFERENCE ONCE THE USER 
GAINS EXPERTISE IN USING THE CROSS-ASSEMBLER. 

WE AT SIERRA DIGITAL LOOK FORWARD TO DEVELOPING MORE ASSEMBLERS IN 
OUR X8 SERIES TO PROVIDE YOU, THE USER, WITH THE MEANS OF 
PIONEERING THE NEW WORLD OF MICROPROCESSORS. 


# 2. 0. 0 OPERATION. 


SIERRA DIGITAL'S CROSS-ASSEMBLER IS AN 8K, TWO PASS ASSEMBLER WHICH 
RUNS UNDER THE OS/8 OPERATING SYSTEM. THE CROSS-ASSEMBLER IS CODED 
IN PDP/8 ASSEMBLY LANGUAGE (PALS) TO GIVE FAST EXECUTION TIMES. 
(LESS THAN 30 SECONDS FOR A NORMAL 4K BYTE PROGRAM IS TYPICAL). 

PASS 1 READS THE INPUT FILES AND SETS UP THE SYMBOL TABLES. PASS 2 
THEN GENERATES THE OUTPUT FILE IN THE BINARY (OBJECT) FORMAT OF THE 
PARTICULAR MICROPROCESSOR. THE OUTPUT FILE CAN BE CHANGED TO BNPF 
FORMAT THROUGH USE OF THE /B RUN-TIME OPTION. 

A THIRD ASSEMBLY PASS IS DONE WHEN A LISTING OUTPUT FILE IS SPECI¬ 
FIED. WHEN NO BINARY FILE IS SPECIFIED, THE ASSEMBLER GOES DIRECTLY 
TO THE PASS 3 LISTING. 





#2. O. O 


THE CROSS-ASSEMBLER IS NOT RESTARTABLE. IF AN ATTEMPT IS MADE TO 
RESTART THE ASSEMBLER WITH A .ST COMMAND, THE KEYBOARD MONITOR 
RETURNS A "NO!!" . 

TYPING CTRL/C WILL HALT ASSEMBLY AND CAUSE AN IMMEDIATE EXIT TO THE 
KEYBOARD MONITOR. 

TYPING CTRL/O AT THE KEYBOARD DURING ASSEMBLY WILL SUPPRESS THE 
LISTING OF ERROR MESSAGES TO THE CONSOLE DURING PASSES 1 AND 2. THE 
OUTPUT FILE WILL STILL SHOW THE ERROR MESSAGES IMMEDIATELY BEFORE 
THE LINE THAT IS IN ERROR. 


# 2. 1. 0 LOADING AND SAVING THE CROSS-ASSEMBLER. 


THE CROSS-ASSEMLER IS PROVIDED IN BINARY FORMAT ON PAPER TAPE OR IN 
BOTH BINARY AND IMAGE FORMATS ON FILE-STRUCTURED MEDIA. 

TO LOAD THE ASSEMBLER FROM PAPER TAPE AND SAVE IT, PLACE THE TAPE 
IN THE READER AND CALL THE ABSOLUTE LOADER: 

. R ABSLDR 
*PTR:* 

. SAVE SYS:XNAME 

FROM FILE STRUCTURED MEDIA, THE IMAGE FORMAT PROGRAM MAY BE COPIED 
DIRECTLY TO THE SYSTEM DEVICE OR THE BINARY FORMAT FILE MAY BE 
LOADED WITH THE ABSOLUTE LOADER. MODIFICATIONS TO THE IMAGE FILE, 
SUCH AS INVERTING THE SENSE OF A RUN-TIME OPTION, MAY BE 
IMPLEMENTED ACCORDING TO THE NOTES IN SECTION # 11.0.0 . 


# 2. 2. 0 CALLING SEQUENCE. 


ONCE LOADED AND SAVED, THE CROSS-ASSEMBLER IS CALLED FROM THE 
SYSTEM DEVICE BY TYPING: 

. R XNAME 

THE ASSEMBLER CALLS THE COMMAND DECODER WHICH RESPONDS WITH AN 
ASTERISK IN THE LEFT HAND MARGIN. THE USER MAY THEN TYPE IN THE 
INPUT AND OUTPUT FILE SPECIFICATIONS AND RUN-TIME OPTIONS: 

*DEV:BIN,DEV:LISTCDEV: INI, . . . DEV: IN9/0PT 

THE FIRST OUTPUT FILE IS THE MICROPROCESSOR BINARY OBJECT FILE 
WRITTEN IN THE FORMAT SPECIFIED BY THE VENDOR OF THE PARTICULAR 
MICROPROCESSOR. (SEE SECTION 12. 0. 0 FOR THE FORMAT SPECIFICATIONS). 





# 2 . 2 . 0 


THE SECOND OUTPUT FILE IS THE OPTIONAL LISTING. WHEN ONLY THE FIRST 
OUTPUT FILE IS SPECIFIED, THE ASSEMBLER ASSUMES THAT IT WILL BE THE 
BINARY OUTPUT FILE AND THE LISTING IS OMITTED. 

THE FOLLOWING EXAMPLE SPECIFIES FILE ,, IN1" TO BE READ FROM DECTAPE 
0 AND THE BINARY (OBJECT) FILE TO BE OUTPUT TO THE PAPER TAPE PUNCH 
WITH NO LISTING. 

. R XNAME 
*PTP:CDTAO:INI 

THIS EXAMPLE SPECIFIES 2 FILES AS THE SOURCE INPUT (FROM THE DSK: 
DEVICE) WITH ONLY THE PASS 3 LISTING BEING OUTPUT TO THE LINE 
PRINTER: 


. R XNAME 
*, LPT: <IN1, IN2 

UP TO NINE INPUT FILES CAN BE SPECIFIED AS ONE PROGRAM WHERE THE 
LAST FILE IS TERMINATED WITH AN . END STATEMENT. 

# 2. 3. 0 INPUT/OUTPUT FILE EXTENSIONS. 


IF THE EXTENSION TO AN INPUT FILE NAME IS OMITTED, THE ASSEMBLER 
ASSUMES THE . MS EXTENSION. IF THERE IS NO FILE WITH THAT NAME AND 
AN . MS EXTENSION, THE ASSEMBLER ASSUMES THE NULL EXTENSION. UNLESS 
EXTENSIONS ARE SPECIFIED, THE . MB AND . LS EXTENSIONS ARE ADDED TO 
THE OUTPUT BINARY AND LISTING FILES. 

. MB - MICROPROCESSOR BINARY OUTPUT FILE EXTENSION. 

. LS - OUTPUT LISTING FILE EXTENSION. 

. MS - MICROPROCESSOR SOURCE FILE EXTENSION. 


# 2. 4. 0 RUN-TIME OPTIONS. 


TABLE #1 DESCRIBES THE OPTIONS WHICH MAY BE SPECIFED AT RUN-TIME 
IN THE INPUT LINE TO THE COMMAND DECODER. 

IF ONE OR MORE OF THESE OPTIONS IS CONTINUALLY CALLED, THE USER 
SHOULD CONSIDER MODIFYING THE ASSEMBLER TO INVERT THE SENSE OF THE 
OPTION. THE MODIFICATION NOTES IN SECTION #11.0.0 EXPLAIN HOW THIS 
MAY BE DONE. FOR EXAMPLE, A USER WHO PREFERS TO OUTPUT FILES IN 
BNPF FORMAT RATHER THAN BINARY CAN INVERT THE SENSE OF THE /B 
OPTION. THEN THE BINARY FILES ARE NORMALLY WRITTEN IN BNPF FORMAT. 
USE OF THE /B OPTION THEN CAUSES THE OUTPUT FILE TO BE WRITTEN IN 
THE STANDARD MICROPROCESSOR BINARY CODE. SPACE IS PROVIDED IN 
TABLE #1 TO CHECK OFF WHICH OPTIONS HAVE BEEN INVERTED FOR YOUR 
REFERENCE. 





TABLE #1. RUN-TIME OPTIONS. 


#2. 4. 0 


^^♦♦♦tf***#*************************#*************-^************* 

OPTION MEANING INVERT? 

********************************* 4 ^*#***#******#**#*************** 

/B THE BINARY OUTPUT FILE IS WRITTEN IN BNPF FORMAT. - 

INSTEAD OF IN THE MICROPROCESSOR VENDOR'S STANDARD 
BINARY FORMAT. 

FOR THE BNPF FORMAT, THE BINARY OUTPUT IS CONVERTED 
TO ASCII TEXT WHERE 

M B" INDICATES THE BEGINNNING OF A BYTE, 

"F" INDICATES THE END OF A BYTE, 

"P" INDICATES A 1 BIT AND 
"N" INDICATES A 0 BIT. 

FOUR BYTES , SEPARATED BY SPACES, ARE WRITTEN PER 
LINE. THE ADDRESS OF THE FIRST BYTE IS GIVEN IN 
SIX DIGIT OCTAL AT THE BEINNING OF THE LINE. 

LEADING ZEROES IN THE ADDRESS ARE CONVERTED TO 
SPACES. EACH LINE IS PRECEDED BY 2 SPACES. LEADER 
CONSISTS OF 100 NULL CHARACTERS WITH 20 RUBGUTS 
IMMEDIATELY PRECEEDING AND FOLLOWING THE ASCII 
TEXT. 

EXAMPLE: THE FOLLOWING CODE IS SHOWN REWRITTEN IN 

BNPF FORMAT. 


. ORG 100 

. BYTE 27, C7» AF, D7, FF, 72, 0, DO 

100 BNNPNNPPPF BPPNNNPPPF BPNPNPPPPF BPPNPNPPPF 
104 BPPPPPPPPF BNPPPNNPNF BNNNNNNNNF BPPNPNNNNF 


/E INHIBIT ERROR MESSAGES TO THE CONSOLE. 

NORMALLY ERROR MESSAGES ARE OUTPUT TO THE CONSOLE 
DURING ASSEMBLY PASSES 1 AND 2. SINCE ERROR MESS¬ 
AGES ARE INCLUDED IN THE LISTING, USERS WITH SLOW 
CONSOLE DEVICES SUCH AS TTY'S CAN SPEED ASSEMBLY 
TIME WITH THIS OPTION. 

ALSO, IF THE BINARY FILE IS TO BE OUTPUT TO THE 
CONSOLE DEVICE, THE ERROR MESSAGES AND BINARY 
OUTPUT LINES WILL BE INTERMIXED. THE /E OPTION WILL 
INHIBIT ALL BUT FATAL ERROR MESSAGES SO THAT ONLY 
THE BINARY FILE IS OUTPUT. 







TABLE #1. RUN-TIME OPTIONS. (CONT. ) #2. 4. 0 


***************************** *#*********#*******■#••#■•*•*•#*#■** 

OPTION MEANING INVERT? 

**********#***#**#*****##**#*****#**************•#•*■»{•*•#•■*•*■#•■#•■*•■#•*■#■***■#•* 

/H INHIBIT HEADINGS AND PAGINATION. - 

NORMALLY, THE ASSEMBLER AUTOMATICALLY PAGES THE 
OUTPUT, ADDING A HEADER TO THE TOP OF THE PAGE. USE 
OF THE /H OPTION WILL ELIMINATE THE HEADING AND THE 
PAGINATION. 

/J LIST UNASSEMBLED STATEMENTS AND CONDITIONAL - 

ASSEMBLY PSEUDO-OPS. 

STATEMENTS WHICH DO NOT GET ASSEMBLED DUE TO 
CONDITIONAL ASSEMBLY PSEUDO-OPS ARE NORMALLY NOT 
LISTED. NEITHER ARE THE CONDITIONAL PSEUDO-OPS 
THEMSELVES. USE OF THE /J OPTION WILL ADD THESE 
STATEMENTS TO THE LISTING. 

/K EXPAND SYMBOL TABLE STORAGE INTO EXTRA CORE. - 

NORMALLY MOST OF FIELD 1 IS USED FOR BOTH LOCAL AND 
NORMAL USER SYMBOL STORAGE. USE OF THE /K OPTIONS 
EXPANDS CORE USAGE TO 12K WHERE THE LOCAL SYMBOL 
TABLE RESIDES IN FIELD 2 AND THE REGULAR SYMBOL 
TABLE RESIDES IN FIELD 1. 

/L OUTPUT LEADER IN BINARY FILE FOR . ORG STATEMENTS - 

THIS OPTION MAY BE USED TO PHYSICALLY SEPARATE 
DISCONTINUOUS SECTIONS OF THE BINARY OUTPUT ON A 
PAPER TAPE. 

/G OUTPUT LISTING WITH BINARY CODE IN OCTAL FORMAT. - 

THE GENERATED BINARY CODE IS NORMALLY PRINTED IN 
HEXADECIMAL AT THE LEFT OF THE PROGRAM STATEMENTS 
IN THE LISTING FILE. THE /O OPTION WILL CAUSE THE 
BINARY CODE TO BE LISTED IN OCTAL INSTEAD OF 
HEXADECIMAL. 

/N LIST ONLY THE SYMBOL TABLE. - 

THE THIRD PASS LISTING NORMALLY CONSISTS OF THE 
STATEMENT LISTING PLUS THE USER SYMBOL TABLE 
LISTING. THE /N OPTION CAUSES ONLY THE SYMBOL TABLE 
TO BE LISTED. 

/P INCLUDE NORMALLY UNLISTED PSEUDO-OPS IN THE LISTING- 

SOME PSEUDO-OPS WILL NOT BE LISTED BY PASS 3 UNLESS 
THE /P OPTION IS USED. 

/S OMIT THE SYMBOL TABLE FROM LISTING. - 

ONLY THE PROGRAM STATEMENTS ARE LISTED WITH THIS 
OPTION. 













TABLE #1. RUN-TIME OPTIONS. <CONT. ) #2. 4. 0 


****************************************************************** 
OPTION MEANING INVERT? 

HHHt*************************************************************** 

/T REPLACE FORM/FEED WITH 3 CR/LF'S. - 

WHEN LISTING TO A DEVICE SUCH AS A TTY WHICH DOES 
NOT HAVE A FORM/FEED CONTROL/ USE OF THE /T OPTION 
WILL REPLACE THE FORM/FEED WITH 3 BLANK LINES . 

/W INHIBIT WARNING MESSAGES. - 

WHEN WARNING MESSAGES CAN BE SAFELY IGNORED/ THIS 
OPTION WILL PREVENT THEM FROM BEING OUTPUT. 

/O USER FLAGS/ USED WITH THE ? OPERATOR/ SEE SECTION 

TO /9 # 8. 1. 4 . 

**#***#*********************#***#***#*****#***#*#*****•#••#•■#••#•■#•*■#■•#••#■•«••#•#• 


# 3. 0. 0 ASSEMBLER CHARACTER SET. 


THE FOLLOWING CHARACTERS ARE LEGAL SOURCE CODE CHARACTERS: 

1) ALPHABETICS A-Z, UPPER CASE ASCII 

2) NUMERICS 0-9 

3) THE SPECIAL CHARACTERS LISTED BELOW. 

*##******#*#*#■**##**##***##**##*###**#**#*■#■ a-#*****#*##***** 

* MULTIPLICATION 

/ DIVISION 

& BOOLEAN AND 

! INCLUSIVE OR 

+ ADDITION 

SUBTRACTION 

C 3 PRECEDENCE INDICATORS 

UNIVERSAL UNARY OPERATOR <UPARROW). USED WITH: 

'-C - COMPLEMENT (UPARROW C) 

•-■B - BINARY RADIX INDICATOR (UPARROW B) 

'••D - DECIMAL RADIX INDICATOR (UPARROW D) 

'-H - HEXADECIMAL RADIX INDICATOR (UPARROW H) 
''0 - OCTAL RADIX INDICATOR (UPARROW 0) 

--L - LEAST SIGNIFICANT BYTE ACCESS OPERATOR 
''M - MOST SIGNIFICANT BYTE ACCESS OPERATOR 
i COMMENT INDICATOR 

" OR •- ASCII INDICATOR 

? USER FLAG OPERATOR 

CURRENT LOCATION COUNTER (PERIOD) 





# 3. 0. 0 


THE CARRIAGE RETURN CHARACTER IS RECOGNIZED AS THE TERMINATOR FOR 
EACH SOURCE LINE. THE LINE-FEED, RUBOUT, FORM-FEED, AND NULL 
CHARACTERS ARE IGNORED BY THE ASSEMBLER. FORM-FEED CHARACTERS 
OCCURING IN THE SOURCE HAVE NO AFFECT ON THE LISTING. ALL ASCII 
CHARACTERS MAY BE USED IN THE COMMENT FIELD OF A STATEMENT. 


# 4. 0. 0 STATEMENT FORMAT. 


STATEMENTS ARE WRITTEN IN THE GENERAL FORM: 

LABEL OPERATOR OPERAND ; COMMENT 

LABELS MUST START IN COLUMN 1. THEY MAY BE DIRECTLY FOLLOWED WITH 
AN OPTIONAL COMMA IF DESIRED. THE MODIFICATION NOTES EXPLAIN HOW TO 
REPLACE THE COMMA WITH ANOTHER DELIMITER SUCH AS A COLON. 

OPERATORS MUST BE SEPARATED FROM THE LABEL WITH AT LEAST ONE SPACE 
OR TAB. WHEN NO LABEL IS PRESENT, THE OPERATOR MAY BEGIN IN ANY 
COLUMN BEYOND COLUMN 1. 

THE OPERAND (IF ANY) MUST BE SEPARATED FROM THE OPERATOR WITH AT 
LEAST ONE SPACE OR TAB. 

THE COMMENT (IF ANY) MUST BE SEPARATED FROM THE OPERAND (OR 
OPERATOR IF THERE IS NO OPERAND BY A SEMICOLON (;). 

AN INPUT LINE MAY BE UP TO 127 CHARACTERS LONG (NOT INCLUDING THE 
CARRIAGE RETURN). WHEN THE INPUT LINES ARE OUTPUT TO THE LISTING 
FILE, ANY CHARACTERS AFTER THE 72D COLUMN ARE WRITTEN ON THE NEXT 
LINE(S) BEGINNING AT THE 25TH COLUMN OF THE FIRST SOURCE LINE 
(NORMAL COMMENT COLUMN). SEE THE MODIFICATION NOTES IN SECTION 
#11. 0. 0 TO ADJUST FOR NARROWER OR WIDER PAGE OUTPUT. THE CARRIAGE 
RETURN IS A TERMINATOR FOR BOTH THE STATEMENT AND THE LINE. ONLY 
ONE STATEMENT IS ALLOWED PER 127 CHARACTER LINE. 




# 4. 1. 0 CODING CONVENTIONS: 


# 4. 1. 0 


ALTHOUGH THE ASSEMBLER WILL ACCEPT PROGRAMS WRITTEN IN FREE FORMAT, 
THE USE OF TABS MAKES FOR MORE READABLE CODE. TAB STOPS ARE SET 
EVERY 8 CHARACTERS IN THE LINE SO THAT THE USE OF THE TAB KEY 
SIMPLIFIES INPUT. GENERALLY: 


LABELS 

OPERATORS 

OPERANDS 

COMMENTS 


OCCUPY THE FIRST TAB FIELD, 
OCCUPY THE SECOND TAB FIELD, 
OCCUPY THE THIRD TAB FIELD, 
OCCUPY THE REMAINING FIELDS, 


COLUMNS 1 THROUGH 8 
COLUMNS 9 THROUGH 16. 
COLUMNS 17 THROUGH 24. 
COLUMNS 25 THROUGH 127 


# 4. 2. 0 LABELS. 


A LABEL IS A SYMBOL WHICH PRECEDES THE OPERATOR AND MUST FOLLOW THE 
SYMBOL NAMING CONVENTIONS DESCRIBED IN SECTION # 6. 2. 0 . IN ALL BUT 
THE SYMBOL DEFINITION PSEUDO-OPS, <. EQU, . SET, . DINST ) THE LABEL 
IS A LOCATION TAG AND IS EQUAL TO THE VALUE OF THE CURRENT LOCATION 
COUNTER. 

EXAMPLE: 

2 1 . ORG 201 

0 6 LABEL1 .EQU 6 ;LABEL1=6 

201 1 LABEL2 .BYTE 1 ;LABEL2=L0CATI0N TAG=201 

NOTE THAT A JUMP TO LABEL1 WILL TRANSFER TO ADDRESS 6 WHILE A JUMP 
TO LABEL2 GOES TO ADDRESS 201. 

A LABEL LACKING BOTH AN OPERATOR AND OPERAND IS SET EQUAL TO THE 
VALUE OF THE NEXT ADDRESS TO BE ASSEMBLED. IF USED AT THE 
BEGINNING OF THE PROGRAM, IT IS SET EQUAL TO THE VALUE OF THE FIRST 
ADDRESS. WHEN A SOLITARY LABEL IS FOLLOWED BY AN . ORG STATEMENT, 
IT RETAINS THE ORIGINAL VALUE ASSIGNED BEFORE THE ORIGIN CHANGE. 


# 4. 3. 0 OPERATORS. 


AN OPERATOR IS A MNEMONIC WHICH INDICATES THE ACTION TO BE 
PERFORMED AND IS EITHER A PSEUDO-OP OR ONE OF THE MICROPROCESSOR 
INSTRUCTIONS. PSEUDO-OPS ARE DESCRIBED IN SECTION #9. 0. 0. THE 
MICROPROCESSOR INSTRUCTION SET IS DESCRIBED IN SECTION #13. 0. 0 . 
THESE OPERATORS SHOULD NOT BE CONFUSED WITH ARITHMETIC OPERATORS 
USED IN OPERAND EXPRESSIONS. 






# 4. 4. 0 OPERANDS. 


# 4. 4. 0 


AN OPERAND REPRESENTS THE PART OF THE INSTRUCTION WHICH IS TO BE 
ACTED ON. IT CAN BE A TERM OR AN EXPRESSION. 

THE . BYTE, . DBYTE, AND . ADDR PSEUDO-OPS CAN HAVE MULTIPLE OPERANDS. 

REFER TO THE EXPLANATION OF EACH OPERATOR FOR THE PROPER OPERAND 
FORMAT. 

IT SHOULD BE NOTED THAT OPERAND EXPRESSIONS ARE EVALUATED TO A 
SINGLE NUMERICAL VALUE BY THE ASSEMBLER. BINARY CODE IS NOT 
GENERATED TO MAKE THE MICROPROCESSOR EVALUATE THE EXPRESSION. 


# 4. 5. 0 TERMS AND EXPRESSIONS. 


A TERM IS A SINGLE VALUE, A CONSTANT OR SYMBOL. THE CURRENT 
LOCATION COUNTER (REPRESENTED BY A PERIOD) IS CONSIDERED A TERM. 

TERMS ARE COMBINED WITH OPERAND ARITHMETIC OPERATORS TO FORM 
EXPRESSIONS. 

EXAMPLE. IN THE INSTRUCTION BELOW THE OPERAND IS AN EXPRESSION 
WHICH HAS TWO ARITHMETIC OPERATORS AND THREE TERMS. 

SYMBOL . EQIJ 1+NEW * 15 

16 BIT INTEGER ARITHMETIC IS USED TO EVALUATE EXPRESSIONS. 


# 5. 0. 0 NUMERIC CONSTANTS. 


A CONSTANT IS A NUMERIC VALUE REPRESENTED BY A STRING OF DIGITS. 
THE DEFAULT RADIX OR TEMPORARY RADIX INDICATORS IDENTIFY THE RADIX 
OF THE CONSTANT. A CONSTANT WITHOUT ANY TEMPORARY RADIX INDICATOR 
IS CONSIDERED TO BE IN THE DEFAULT RADIX, WHICH IS INITIALLY 
HEXADECIMAL. 

EXAMPLE: THE HEXADECIMAL NUMBER 16 <22 IN BASE 10) IS STORED IN 

"VALUE" : 

0 16 VALUE . EQU 16 

THE MAXIMUM VALUE FOR A CONSTANT IS 65535 (BASE 10 UNSIGNED). 

THE MINIMUM VALUE FOR A CONSTANT IS -32768 (BASE 10 SIGNED). 






# 5. 1.0 CONSTANTS WITH RADIX INDICATORS. 


# 5. 1. 0 


CONSTANTS IN A BASE DIFFERENT FROM THAT OF THE DEFAULT RADIX CAN BE 
SPECIFIED THROUGH USE OF THE TEMPORARY RADIX INDICATORS. THESE 
INDICATORS ARE VERY USEFUL FOR ENTERING INDIVIDUAL CONSTANTS. 
HOWEVER/ IF A LARGE GROUP OF VALUES IN ANOTHER RADIX MUST BE 
ENTERED/ IT IS MORE CONVENIENT TO CHANGE THE DEFAULT RADIX USING 
THE PSUEDO-OPS DESCRIBED IN SECTION # 9. 2. 0 . 

THE TEMPORARY RADIX INDICATORS ARE: 

~B BINARY 

"D DECIMAL 

-•H HEXADECIMAL 

"•"0 OCTAL 


THE IS THE UPARROW CHARACTER (UNIVERSAL UNARY OPERATOR). 

A HEXADECIMAL CONSTANT WHICH DOES NOT BEGIN WITH A NUMBER SHOULD BE 
WRITTEN WITH A LEADING ZERO TO DISTINGUISH IT FROM FROM A SYMBOL. A 
RADIX INDICATOR PRECEDING A SYMBOL IS IGNORED. 

EXAMPLE: THE FIRST STATEMENT IS VALID/ THE SECOND IS NOT. 

VALUE . ECU •‘"•H0A302 i VALUE=A302, BASE 16 

VALUE . EQU "HA302 ;VALUE * SYMBOL A302 

SINCE THE SYMBOL A302 MAY NOT EXIST/ THE SECOND STATEMENT WILL 
PROBABLY CAUSE AN UNDEFINED SYMBOL ERROR. TEMPORARY RADIX 
INDICATORS AFFECT THE NEXT DIGIT STRING IN THE EXPRESSION UNLESS A 
SYMBOL NAME OR BINARY OPERATOR OCCURS FIRST. IN THAT CASE/ THE 
TEMPORARY RADIX INDICATOR WOULD BE IGNORED. NO ERROR MESSAGE IS 
GIVEN. 


# 5.2.0 CONSTANTS WITH ASCII INDICATORS. 


THE " AND •' INDICATORS ARE USED TO FORM THE 7 BIT ASCII VALUE OF A 
CHARACTER. THERE ARE FOUR ACCEPTABLE WAYS TO WRITE THE INDICATORS: 

"A" OR "A OR •'A-' OR 'A ALL EQUAL 41 (BASE 16). 

NOTE THAT THE CLOSING QUOTE IS OPTIONAL/ BUT IF USED IT MUST MATCH 
THE OPENING QUOTE. ONLY ONE CHARACTER CAN FOLLOW THE INDICATOR. 

THE " IS SPECIALLY HANDLED IN THE . BYTE PSEUDO-OP WHERE IT IS USED 
TO INPUT TEXT STRINGS. SEE SECTION # 9. 3. 1 . 





# 6 . 0 . 0 


# 6. 0. 0 SYMBOLS. 


THE WORD “SYMBOL" IS USED HERE AS A GENERAL TERM FOR ANY MNEMONIC 
WHICH IS TO HAVE A VALUE. THIS IS IN CONTRAST TO AN OPERATOR, WHICH 
IS A MNEMONIC WHICH SPECIFIES A PROCESS. 

A LABEL IS A SYMBOL THAT PRECEDES AN OPERATOR IN THE STATEMENT. IF 
THE LABEL IS USED TO STORE THE VALUE OF THE CURRENT LOCATION 
COUNTER , IT IS CALLED A LOCATION TAG. 


# 6. 1. 0 PERMANENT SYMBOLS. 


PERMANENT SYMBOLS ARE THE CROSS-ASSEMBLER PSEUDO-OPS AND 
MICROPROCESSOR OPERATORS. IF NECESSARY, THE . DINST STATEMENT CAN BE 
USED TO RENAME A MICROPROCESSOR OPERATOR. THE CROSS-ASSEMBLER 
PSEUDO-OPS CANNOT BE USED IN A . DINST INSTRUCTION. THE TABLES IN 
THE APPENDICES SUMMARIZE THE PERMANENT SYMBOL SET. 


# 6. 2. 0 USER DEFINED SYMBOLS. 


THESE SYMBOLS CAN BE LOCATION TAGS OR REPRESENT A VALUE. 

A SYMBOL IS A STRING OF FROM ONE TO SIX ALPHANUMERIC CHARACTERS 
DELIMITED BY A NON-ALPHANUMERIC CHARACTER. USER-DEFINED SYMBOLS 
MUST CONFORM TO THE FOLLOWING RULES: 

1) THE CHARACTERS MUST BE LEGAL ALPHA-NUMERICS. 

(A-Z OR 0—9) 

2) THE FIRST CHARACTER MUST BE ALPHABETIC (A-Z). 

3) ONLY THE FIRST SIX CHARACTERS ARE USED, ANY 
OTHERS ARE IGNORED. SYMBOLS ARE STORED IN THE 
SYMBOL TABLE AND REFERENCED ONLY BY THE FIRST 
SIX CHARACTERS. 

4) A USER-DEFINED SYMBOL CANNOT HAVE THE SAME 
NAME AS ANY OF THE PERMANENT SYMBOL NAMES. 

AS THE PERIOD IS CONSIDERED AS PART OF THE 
ASSEMBLER PSEUDO-OP NAME, A USER-DEFINED SYM¬ 
BOL WHICH IS IDENTICAL EXCEPT FOR THE LEADING 
PERIOD IS LEGAL. 






# 6. 3. 0 LOCAL SYMBOLS. 


# 6. 3. O 


OFTEN/ WHEN PROGRAMMING SHORT SECTIONS OF CODE WHICH INVOLVE 
NUMEROUS JUMP OR BRANCHING INSTRUCTIONS/ THE USER FINDS IT 
DIFFICULT TO CREATE MEANINGFUL LABELS THAT WILL NOT CONFLICT WITH 
OTHER SYMBOLS IN THE PROGRAM. IN CASES LIKE THIS/ LOCAL SYMBOLS CAN 
BE USED INSTEAD OF REGULAR SYMBOLS. 


LOCAL SYMBOLS HAVE THE FORMAT "$N" WHERE "N" IS A DECIMAL INTEGER 
FROM 0-255 INCLUSIVE. 

LOCAL SYMBOLS MUST BE DEFINED AND REFERENCED WITHIN LOCAL SYMBOL 
BLOCKS. LOCAL SYMBOL BLOCKS ARE SECTIONS OF THE PROGRAM THAT START 

ON A STATEMENT HAVING A REGULAR SYMBOL USED AS A LOCATION TAG AND 

END ON THE STATEMENT JUST BEFORE THE OCCURANCE OF THE NEXT REGULAR 
SYMBOL LOCATION TAG. NOTE THAT LABELS FOR THE . EQU/ . DINST AND 
. SET PSEUDO-OPS ARE NOT LOCATION TAGS AND DO NOT DELIMIT LOCAL 
SYMBOL BLOCKS. 

THERE IS NO EFFECTIVE LIMIT TO THE SIZE OF A LOCAL SYMBOL BLOCK. 

THE SAME LOCAL SYMBOL CAN BE DEFINED AND USED IN AN UNLIMITED 

NUMBER OF LOCAL SYMBOL BLOCKS. 


EXAMPLE: 


TAG1 

. BYTE 

"TEXT 

*1 

. EQU 

VALUE 

$2 

. EQU 

-1 

VALU1 

. EQU 

S1-S2 

TAG2 

. BYTE 

’•TEXT 

SI 

. EQU 

VALU1 

$2 

. EQU 

-2 

VALIJ2 

. EQU 

$1**2 

TAGS 

. BYTE 

"TEXT 


SYMBOL BLOCK BEGINS 
DEFINE LOCAL *1 
DEFINE LOCAL *2 
CALCULATE NEW VALUE 
NEW SYMBOL BLOCK 
DEFINE LOCAL *1 
DEFINE LOCAL $2 
CALCULATE NEW VALUE 
ENDS SECOND BLOCK 


# 7. 0. 0 CURRENT LOCATION COUNTER. 


THE CURRENT LOCATION COUNTER IS INDICATED BY A PERIOD. IT 
REPRESENTS THE ADDRESS OF THE NEXT BYTE TO BE ASSEMBLED. 

THE CURRENT LOCATION COUNTER CANNOT BE USED IN THE LABEL FIELD. 






# 7. 0. 0 


AT THE BEGINNING OF THE SOURCE INPUT THE CURRENT LOCATION COUNTER 
IS SET TO ZERO. IT CAN BE REASSIGNED THROUGH USE OF THE . ORG 
PSEUDO-OP. 

EXAMPLE: 


0 

60 


. ORG 

60 

; INITIAL ADDRESS 

0 

0 

VALUE 

. EQU 

0 

iNO EFFECT ON . 

60 22 


TAG 

. BYTE 

22 

i . = 60 (BASE 8) 

1 

00 


. ORG 

100 

i REASSIGN COUNTER 

100 10 


TAG1 

. BYTE 

10 

i . « 100 


LOCATION TAGS ARE ALWAYS SET EQUAL TO THE VALUE OF THE CURRENT 
LOCATION COUNTER WHEN THEY ARE ASSEMBLED. IN THE EXAMPLE ABOVE, THE 
LOCATION TAG "TAG" ■ 60. 

THE CURRENT LOCATION COUNTER IS AUTOMATICALLY UPDATED IN THE 
ASSEMBLER AS SOON AS THE CURRENT INSTRUCTION IS ASSEMBLED. NOTE 
THAT IN THE MULTI-OPERAND DATA STORAGE PSEUDO-OPS, (. BYTE, . DBYTE, 
AND . ADDR ) THE LOCATION COUNTER IS CHANGING AS THE OPERANDS ARE 
ASSEMBLED. 

EXAMPLE: THE LOCATION COUNTER IS USED AS AN OPERAND 3 TIMES IN AN 

. ADDR PSEUDO-OP. 

0 20 . ORG 20 

20 20 0 . ADDR 

22 22 0 
24 24 0 

20 20 0 

THE CURRENT LOCATION COUNTER USES THE FULL ADDRESS RANGE OF THE 
MICROPROCESSOR. 


# 3. 0. 0 THE ARITHMETIC OPERATOR SET. 


THERE ARE TWO TYPES OF ARITHMETIC OPERATORS: UNARY AND BINARY 
OPERATORS. 


UNARY OPERATORS 
FOLLOWING THEM. 

ACT 

ON 

ONLY 

ONE ITEM, 

THE 

TERM 

OR 

EXPRESSION 

BINARY OPERATORS 

ACT 

ON 

TWO ITEMS: 

THE 

TERM 

OR 

EXPRESSION 

PRECEEDING THEM 

AND 

THE 

TERM 

OR EXPRESION 

FOLLOWING 

THEM. 






# 8. 1. O UNARY OPERATORS. 


# 8. 1. O 


THE + (PLUS) AND - (MINUS) UNARY OPERATORS ASSIGN A POSITIVE OR 
NEGATIVE SIGN TO THE EXPRESSION FOLLOWING THEM. AN EXPRESSION IS 
ASSUMED TO BE POSITIVE IF NOT OTHERWISE SPECIFIED. 


# 8. 1. 2 BYTE ACCESS OPERATORS. 


THE -'L AND '"M (WHERE IS THE UP ARROW CHARACTER) ARE UNARY 

OPERATORS WHICH PROVIDE ACCESS TO THE LEAST AND MOST SIGNIFICANT 8 
BIT BYTES OF THE VALUE OF AN EXPRESSION OR TERM. 

EXAMPLE: TO SET "VALUE" EQUAL TO THE MOST SIGNIFICANT BYTE OF 
3B61 (BASE 16), THE STATEMENT BELOW IS USED. 

VALUE .SET 'T13B61 i VALUE ■ 003B 

THIS NEXT STATEMENT TAKES THE LEAST SIGNIFICANT BYTE. 

VALUE . SET •"•L3B61 ; VALUE ■ 0061 

BYTE ACCESS OPERATORS MAY BE COMBINED WITH THE OTHER UNARY 
OPERATORS AND THE RADIX INDICATORS. 


# 8. 1. 3 THE COMPLEMENT OPERATOR. 


THE r 'C (UPARRQW C) IS A LOGICAL UNARY OPERATOR WHICH COMPLEMENTS 
THE EXPRESSION FOLLOWING IT. 

EXAMPLE: 

VALUE . EQU •'"C7241 i VALUE = 8DBE 

THE COMPLEMENT OPERATOR CAN BE COMBINED WITH THE OTHER UNARY 
OPERATORS AND THE RADIX INDICATORS. 






# 3. 1. 4. ? OPERATOR. 


# 8. 1. 4 


THIS IS THE USER FLAG OPERATOR* A UNARY OPERATOR USED IN CONJUNC¬ 
TION WITH THE COMMAND DECODER USER FLAG OPTIONS (/O TO /9). IT HAS 
THE FORM 7EXPRESSI0N AND MAY BE USED IN OPERANDS LIKE ANY OTHER 
TERM. THE RESULTING VALUE OF THE QUESTION MARK OPERATOR EQUALS 1 IF 
THE VALUE OF ITS EXPRESSION MATCHES A USER FLAG THAT WAS SPECIFIED 
TO THE COMMAND DECODER AT RUN-TIME. OTHERWISE IT EQUALS 0. THIS 
OPERATOR IS USEFUL FOR CONTROLLING CONDITIONAL ASSEMBLY AND LISTING 
PARAMETERS WITHOUT HAVING TO MODIFY THE SOURCE FILE. 

EXAMPLE: THE /2 OPTION WAS SPECIFIED TO THE COMMAND DECODER AT 

RUN-TIME. 

. R XNAME 

*BIN,L0UT<S0URCE/2 

THE SOURCE FILE CONTAINS THE FOLLOWING .LIST STATEMENTS: 


LIST ?2-l 

LIST 1 


AT THE FIRST . LIST STATEMENT* THE ?2 TERM EQUALS 1 SINCE /2 WAS 
SPECIFED AT RUN-TIME. THE OPERAND ( ?2-l > EQUALS ZERO. THEREFORE 
LISTING IS INHIBITED UNTIL THE SECOND . LIST INSTRUCTION. AS THE 
OPERAND VALUE OF THIS STATEMENT IS 1, LISTING IS ENABLED AGAIN. 
NOTE THAT IF THE /2 OPTION WAS NOT SPECIFIED* THE INSTRUCTIONS 
AFTER THE FIRST .LIST WOULD BE INCLUDED IN THE "LOUT" FILE LISTING. 


# 8. 2. 0 BINARY OPERATORS. 


SIX SPECIAL CHARACTERS ARE USED TO PERFORM THE FOLLOWING BINARY 
OPERATIONS: 


* MULTIPLICATION 

/ DIVISION 

& BOOLEAN AND 

i INCLUSIVE OR 

+ ADDITION 

SUBTRACTION 






# 8 . 2 . 0 


THE UNARY OPERATORS TAKE PRECEDENCE OVER: THE BINARY OPERATORS 
DURING ASSEMBLY. THE * AND / OPERATORS ARE EXECUTED NEXT, THEN THE 
OTHER BINARY OPERATORS FROM LEFT TO RIGHT. BRACKETS,C AND 3, ARE 
USED TO CHANGE THE ORDER OF PRECEDENCE WHEN NECESSARY. A C IS A 
SHIFT/K ON TTY KEYBOARDS, AND A 3 IS A SHIFT/M. 

EXAMPLE: IN THE STATEMENT BELOW THE OPERAND EXPRESSION IS EVALUATED 
IN THIS ORDER: C A* C -B 3 3 + C C 2/D 3 * C A C C ''B101 3 3 3 

VALUE . EQIJ A*-B+2/D* A C A B101 

ADDITION AND SUBRACTION ARE ACCOMPLISHED BY TWO'S COMPLEMENT 16 BIT 
ARITHMETIC. NO CHECKS FOR OVERFLOW ARE MADE. 

MULTIPLICATION IS ACCOMPLISHED BY REPEATED ADDITION. NO CHECKS FOR 
SIGN OR OVERFLOW ARE MADE. 

DIVISION IS ACCOMPLISHED BY REPEATED SUBRACTION. THE QUOTIENT IS 
THE NUMBER OF SUBTRACTIONS PERFORMED. THE REMAINDER IS NOT SAVED. 
NO CHECKS ARE MADE FOR SIGN. DIVISION BY ZERO RESULTS IN ZERO. 

THE BOOLEAN AND FUNCTION <&) IS A BIT BY BIT LOGICAL AND OF TWO 
NUMBERS: 


THE BOOLEAN INCLUSIVE OR (!) IS A BIT BY BIT LOGICAL OR OF TWO 
NUMBERS. 



* 9. 0. O PSEUDO-OPERATORS. 


# 9. 0. O 


PSEUDO-OPERATORS ARE INSTRUCTIONS TO THE ASSEMBLER WHICH ALLOW 
GREATER FLEXIBILTIY IN PROGRAMMING. 

A SUMMARY OF THE PSEUDO-OPS AND THEIR FUNCTIONS IS GIVEN IN THE 
APPENDIX. 


# 9. 1. 0 ASSIGNMENT PSEUDO-OPS. 


ASSIGNMENT PSEUDO-OPS ARE USED TO DEFINE VALUES, INPUT ASCII TEXT 
AND REASSIGN THE LOCATION COUNTER. 


# 9. 1. 1 . EQU PSEUDO-OP. 


THE . EQU IS USED TO ASSIGN A VALUE TO A SYMBOL. THIS SYMBOL VALUE 
CANNOT BE CHANGED ONCE DEFINED. . EQU IS USEFUL FOR ASSIGNING NAMES 
TO LOCATIONS WHICH ARE NOT LOADED BY THE OBJECT CODE. 

EXAMPLE: 


NAME1 . EQU 300*6 


# 9. 1. 2 . SET PSEUDO-OP. 


THE . SET IS USED EXACTLY LIKE THE . EQU EXCEPT THAT THE SYMBOL CAN 
BE REDEFINED WITH ANOTHER . SET AT ANY POINT IN THE PROGRAM: 

EXAMPLE: THE FOLLOWING IS PERFECTLY LEGAL FOR A . SET BUT NOT AN 
. EQU. 


NAME1 . SET 300*6 
NAME1 . SET 22 

NOTE THAT IT IS GOOD PRACTICE TO USE THE . EQU FOR ASSIGNMENTS 
RATHER THAN THE . SET EXCEPT (OF COURSE) WHERE THERE IS A SPECIFIC 
NEED TO REDEFINE A VALUE. THIS HELPS PREVENT THE ACCIDENTAL 
REDEFINITION OF A VALUE IN A PROGRAM. 


# 9. 1. 3 . DINST PSEUDO-OP. 


THE . DINST IS USED TO GIVE A MICROPROCESSOR OPERATOR ANOTHER NAME. 
THE ORIGINAL OPERATOR NAME WILL STILL BE VALID. NOTE THAT THE 
ASSEMBLER PSEUDO-OPS CANNOT BE RENAMED. 








#9. 1. 3 

EXAMPLE: THE MICROPROCESSOR INSTRUCTION "OPR" IS DEFINED AS 

"NEWOP". ANY FURTHER REFERENCES TO "NEWOP" IN THE PROGRAM WILL BE 
TREATED ACCORDING TO THE DEFINITION OF "OPR". 

NEWOP . DINST OPR 

"NEWOP" IS DEFINED TO BE THE EQUIVALENT TO THE MICROPROCESSOR 
INSTRUCTION "OPR" AND IS ADDED TO THE OPERATOR SET FOR THE 
REMAINDER OF THE ASSEMBLY. 

REFERENCES TO USER DEFINED OPERATORS ARE NOT ALLOWED TO PRECEDE 
THEIR . DINST STATEMENT. 

ASSEMBLER PSEUDO-OPS CANNOT BE USED IN EITHER THE LABEL OR OPERAND 
FIELDS OF ANY STATEMENT AND THEREFORE CANNOT BE DEFINED WITH THE 
. DINST STATEMENT. 

LOCAL SYMBOLS CANNOT BE USED IN THE OPERATOR FIELDS, THEREFORE THEY 
SHOULD NOT BE USED WITH A . DINST STATEMENT. 


# 9. 1. 4 . ORG PSEUDO-OP. 


THE . ORG REASSIGNS THE LOCATION COUNTER. 

THE LOCATION COUNTER WILL BE 0 AT THE START OF THE SOURCE INPUT. 

THE . ORG OPERAND CANNOT BE FORWARD REFERENCED, (REFERRED TO A 
LABEL DEFINED FURTHER ON IN THE PROGRAM) AND CANNOT HAVE A LABEL. 


# 9. 2. 0 DEFAULT RADIX PSEUDO-OPS. 


INITIALLY, THE DEFAULT RADIX IS SET TO HEXADECIMAL SO THAT 
CONSTANTS ARE READ IN AS BASE 16 VALUES. (SEE MODIFICATION NOTES IF 
ANOTHER INITIAL DEFAULT RADIX IS DESIRED. ) 


AT ANY POINT IN THE PROGRAM, THE DEFAULT RADIX CAN BE REASSIGNED 
THROUGH USE OF THESE PSEUDO-OPS: 


. BIN 
. DECM 
. HEX 
. OCT 


i BINARY RADIX 
; DECIMAL RADIX 
i HEXADECIMAL RADIX 
; OCTAL RADIX 


THE DEFAULT RADIX PSEUDO-OPS CANNOT HAVE AN OPERAND OR A LABEL. 


ADDITIONALLY, THE RADIX OF INDIVIDUAL CONSTANTS CAN BE SPECIFIED BY 
THE USE OF THE A B, 'D, ''H AND "'0 INDICATORS. SEE SECTION # 5. 1. 0 . 
THESE INDICATORS DO NOT CHANGE THE DEFAULT RADIX. 





# 9. 3. 0 DATA STORAGE PSEUDO-OPS. 


# 9. 3. 0 


THREE PSEUDO-OPS CAN BE USED TO STORE DATA. THEIR FORMAT IS: 

LABEL PSEUDO-OP OPERAND, OPERAND, .... ; COMMENT 


THE PSEUDO-OPS CAN HAVE AS MANY OPERANDS AS WILL FIT ON ONE 127 
CHARACTER LINE. 


EACH OPERAND CAN BE A SYMBOL,CONSTANT, OR EXPRESSION. COMMAS 
SEPARATE THE OPERANDS. 

THE DOUBLE QUOTE <") CHARACTER IS USED DIFFERENTLY IN THE .BYTE 
COMMAND, BUT THE SINGLE QUOTE (') RETAINS ITS NORMAL FUNCTION. 


# 9. 3. 1 . BYTE PSEUDO-OP. 


THE . BYTE PSEUDO-OP STORES DATA IN SINGLE BYTES OF MEMORY. 
NUMERICAL BYTE VALUES CAN RANGE FROM -128 TO +255 (DECIMAL). 

NORMALLY, DOUBLE QUOTES AND SINGLE QUOTES ARE TREATED IDENTICALLY 
AND ARE USED TO FORM THE ASCII VALUE OF A SINGLE CHARACTER. 

HOWEVER, IN THE . BYTE PSEUDO-OP , THE DOUBLE QUOTE IS USED TO INDI¬ 
CATE TEXT STRINGS. DATA IS STORED SEQUENTIALLY AS IT IS PROCESSED, 
LEFT TO RIGHT. A TEXT STRING MUST BE CLOSED WITH A DOUBLE QUOTE. 

EXAMPLE: THE ASCII VALUES OF THE TEXT ABC IS STORED: 

2 00 . ORG 200 

200 41 .BYTE "ABC",0, 'B 

201 42 

202 43 

203 0 

204 42 

THESE STATEMENTS WOULD BE INVALID: 

. BYTE 'ABC' i THE ' IS NOT FOR TEXT STRINGS 

. BYTE "ABC ; TEXT MUST END WITH A " 


# 9. 3. 2 . DBYTE PSEUDO-OP. 


THE . DBYTE IS SIMILAR TO THE . BYTE EXCEPT THAT IT STORES DOUBLE 
BYTE QUANTITIES. IT DOES NOT ACCEPT TEXT STRINGS. THE THE MOST 
SIGNIFICANT BYTE IS STORED FIRST, THEN THE LEAST SIGNIFICANT BYTE. 






# 9. 3. 3 


# 9. 3. 3 . ADDR PSEUDO-OP. 


THE . ADDR PSEUDO-OP IS THE SAME AS THE . DBYTE PSEUDO-OP EXCEPT THAT 
THE LEAST SIGNIFICANT BYTE IS STORED FIRST. MANY MICROPROCESSORS 
USE THIS REVERSED FORMAT FOR ADDRESSES. FOR EXAMPLE: 

2 00 . ORG 200 

200 1 32 .DBYTE "^3132 ; HEX CONSTANT 

202 32 31 . ADDR ''H3132 ; REVERSED BYTES 


# 9. 3. 4 . ZERO PSEUDO-OP. 


THE . ZERO PSEUDO-OP RESERVES THE NUMBER OF BYTES INDICATED BY THE 
OPERAND AND SETS THEM TO ZERO. 


EXAMPLE: 

16 ADDRESSES, 1 TO 

10 (BASE 16) ARE ZEROED. 

0 1 

. ORG 

1 

1 0 

. ZERO 

10 

11 10 

. BYTE 

10 


ONLY THE FIRST BYTE WILL BE PRINTED IN THE LISTING. THE LOCATION 
COUNTER IS ADVANCED. THE OPERAND OF . ZERO CANNOT BE FORWARD REFER¬ 
ENCED, <REFERED TO A LABEL DEFINED FURTHER ON IN THE PROGRAM). 


# 9. 4. 0 LISTING CONTROL DIRECTIVES. 


THROUGH USE OF THE .LIST, . PAGE AND . TITLE PSEUDO-OPS, PLUS SEVERAL 
RUN-TIME OPTIONS, THE SOURCE PROGRAM CAN BE LISTED IN VARIOUS WAYS 
AT ASSEMBLY TIME. 

NORMALLY, THE ASSEMBLER AUTOMATICALLY PAGES THE OUTPUT, ADDING A 
HEADER AT THE TOP OF THE PAGE. (NOTE THAT PAGE NUMBERS REPRESENT 
THE LISTING PAGE NUMBERS, NOT INPUT FILE PAGES. ) 

NOT ALL PSEUDO-OPS ARE LISTED IN THE OUTPUT. THE CONDITIONAL 
ASSEMBLY AND LISTING CONTROL PSEUDO-OPS ARE NOT LISTED UNLESS THE 
/P OPTION IS SPEC I FED. SEE RUN-TIME OPTIONS # 2. 4. O 

NORMALLY THE STATEMENTS WHICH ARE NOT ASSEMBLED DUE TO CONDITIONAL 
ASSEMBLY ARE NOT LISTED. USE OF THE /J COMMAND DECODER OPTION WILL 
ENABLE LISTING OF THESE STATEMENTS PLUS THE NORMALLY UNLISTED 
CONDITONAL ASSEMBLY PSUEDO-OPS. 

THE PAGINATION AND HEADING CAN BE SUPPRESSED THROUGH USE OF THE /H 
COMMAND DECODER OPTION. 






# 9. 4. 0 


IF THE OUTPUT DEVICE IS ONE WHICH DOES NOT PAGE ON A FORM FEED (A 
TTY), THE /T DECODER OPTION CAN BE USED TO CHANGE THE FORM FEED 
(WHICH NORMALLY STARTS A NEW PAGE) TO 3 CARRIAGE RETURN/LINE FEEDS 
SO THAT PAGES WILL BE SEPARATED BY 3 BLANK LINES IN THE LISTING. 

WARNING MESSAGES ARE NORMALLY OUTPUT TO BOTH THE TERMINAL AND THE 
SOURCE LISTING. TO INHIBIT THESE MESSAGES, THE /W DECODER OPTION IS 
USED. 


# 9. 4. 1 .LIST PSEUDO-OP. 


A LIST FLAG IS USED DURING ASSEMBLY TO INDICATE WHETHER OR NOT THE 
STATEMENTS ARE TO BE LISTED. INITIALLY, THE FLAG IS ON AND STAYS ON 
UNLESS A .LIST PSEUDO-OP IS ENCOUNTERED. 

A .LIST PSEUDO-OP CAN BE USED WITH OR WITHOUT AN OPERAND. A LABEL 
CANNOT BE USED WITH THE .LIST PSEUDO-OP. 

WHEN A .LIST PSEUDO-OP WITHOUT AN OPERAND IS ENCOUNTERED, THE LIST 
FLAG IS INVERTED. 


EXAMPLE: 



. ORG 

200 

VALUE 

. SET 

1 


. LIST 


VALU2 

. SET 

70 


. LIST 



i LIST FLAG INITIALLY ON 
; LISTED 
; LISTED 

i LIST FLAG OFF 
; NOT LISTED 
i LIST FLAG BACK ON 


NOTE THAT UNLESS THE /P OPTION IS USED, THE .LIST OPERATOR ITSELF 
WILL NOT BE LISTED. 


WHEN A .LIST PSEUDO-OP WITH AN OPERAND IS ENCOUNTERED, THEN LISTING 
IS INHIBITED IF THE OPERAND IS EQUAL TO ZERO. (THE LIST FLAG IS 
•SET OFF). IF THE OPERAND IS NOT ZERO, LISTING IS ENABLED. (THE 
LIST FLAG IS SET ON). 


# 9. 4. 2 . PAGE PSEUDO-OP. 


INSERTING A . PAGE PSEUDO-OP IN THE PROGRAM WILL NORMALLY START A 
NEW PAGE BEGINNING WITH THE NEXT LINE. (THE . PAGE STATEMENT ITSELF 
IS NOT NORMALLY LISTED. ) IF THE /P COMMAND DECODER OPTION IS USED, 
THE .PAGE STATEMENT WILL BE THE FIRST LINE OF THE NEW PAGE. 






# 9. 4. 2 


THE /H COMMAND DECODER OPTION INHIBITS THE . PAGE PSEUDO-OP. 
THE . PAGE PSEUDO-OP CAN HAVE NO LABEL OR OPERAND. 


# 9. 4. 3 . TITLE PSEUDO-OP. 


THE . TITLE IS USED TO REPLACE THE HEADING WITH UP TO 32 CHARACTERS 
OF TEXT. ITS FORMAT IS: 

. TITLE HEADING OF 32 CHARACTERS 

THE FIRST CHARACTER AFTER THE . TITLE IS THE PSEUDO-OP DELIMITER 
WHICH CANNOT BE AN ALPHA-NUMERIC CHARACTER THE DELIMITER IS 

CONSIDERED THE FIRST CHARACTER OF THE 32 CHARACTER GROUP AND WILL 
BE PRINTED OUT. ANY TEXT AFTER 32 CHARACTERS WILL BE IGNORED. TABS 
CAN BE USED IN THE HEADING. 

THE /H COMMAND DECODER OPTION INHIBITS THE . TITLE PSEUDO-OP. 

THE /P COMMAND DECODER ENABLES THE LISTING OF THE . TITLE PSEUDO-OP. 

A SEMICOLON DOES NOT DELIMIT THE HEADING TEXT. COMMENTS CAN BE 
MADE ONLY AFTER THE 32 CHARACTER HEADING GROUP. 

WHEN PLACED AT THE BEGINNING OF THE PROGRAM, THE .TITLE PSEUDO-OP 
WILL SET THE HEADING FOR THE FIRST PAGE. THE . TITLE MUST APPEAR 
BEFORE THE FIRST LINE TO BE LISTED. 

EXAMPLE: THE FOLLOWING STATEMENTS WILL CAUSE THE HEADING OF THE 

FIRST PAGE TO BE "*MAIN PROGRAM". 

. TITLE*MAIN PROGRAM 
VALUE . EQU 1 

.LIST VALUE 


# 9. 5. 0 CONDITIONAL ASSEMBLY PSUEDG-OPERATORS. 


THE . IFZERO, . IFNZRO, . IFDEF AND . IFNDEF OPERATORS ARE USED TO 
PROVIDE FOR THE CONDITIONAL ASSEMBLY IN A PROGRAM, SO THAT GROUPS 
OF STATEMENTS CAN BE ADDED <OR OMITTED) DURING THE ASSEMBLY 
PROCESS. EACH IS DESCRIBED INDIVIDUALLY IN THE SECTIONS THAT 
FOLLOW. ALL HAVE THE GENERAL FORM: 


PSEUDO-OP 


OPERAND 


iCOMMENT 





# 9. 5. 0 


EACH OPERAND MUST MEET THE CONDITIONS OF ITS PSEUDO-OP IN ORDER FOR 
THE STATEMENTS THAT FOLLOW IT TO BE ASSEMBLED. IF THE CONDITIONS 
ARE NOT MET; THESE STATEMENTS ARE OMITTED. THE . ENDC PSEUDO-OP 
INDICATES THE END OF THE GROUP OF STATEMENTS WHICH ARE AFFECTED. 
EACH CONDITIONAL PSEUDO-OP MUST HAVE ONE . ENDC STATEMENT. 


CONDITIONAL PSEUDO-OPS CANNOT HAVE LABELS. 


CONDITIONAL 

PSEUDO-OPS CAN 

BE NESTED 

UP TO 4095 LEVELS. 

EXAMPLE: 

VALUE1 

. EQU 

0 

* DEFINE VALUE1 


. IFZERO 

VALUE1 

* VALUE 1 = 0 ? - YES. 


. BYTE 

"TEXT" 

* ASSEMBLED. 


. IFDEF 

VALUE2 

* VALUE2 DEFINED? - NO. 


. BYTE 
. ENDC 

"TEXT" 

; OMITTED. 

* END OF INNER CONDITIONAL 

DOC 

. EQU 
. ENDC 

17 

i ASSEMBLED. 

i END OF OUTER CONDITIONAL 


THE CONDITIONAL PSEUDO-OPS ARE NOT INCLUDED IN THE ASSEMBLY LISTING 
UNLESS THE /P OR /J COMMAND DECODER OPTION IS SPECIFIED. 

ONE CONDITIONAL CAN INHIBIT ANOTHER. 

EXAMPLE: THREE DIFFERENT RESULTS CAN OCCUR IN THE FOLLOWING TYPE OF 
CONDITIONAL NESTING: 


CONDITIONAL 1 
CONDITIONAL 2 


* STATEMENT GROUP 1. 
i STATEMENT GROUP 2. 


. ENDC 
. ENDC 


END CONDITIONAL 2. 
STATEMENT GROUP 3. 
END CONDITIONAL 1. 


IF BOTH CONDITIONALS ARE MET* ALL THE STATEMENTS* GROUPS 1 THROUGH 
3* WILL BE ASSEMBLED. 

IF CONDITIONAL 2 IS NOT MET, BUT CONDITONAL 1 IS MET, THEN GROUP 1 
AND GROUP 3 WILL BE ASSEMBLED. GROUP 2 IS NOT ASSEMBLED. 

IF CONDITIONAL 1 IS NOT MET* CONDITIONAL 2 IS IGNORED AND GROUPS 1 
THROUGH 3 WILL NOT BE ASSEMBLED. 





# 9. 5. 1 . IFZERO PSEUDO-OP. 


# 9 . 5 . 1 


IF THE OPERAND OF THE . IFZERO IS: 

EQUAL TO ZERO - ASSEMBLY IS UNAFFECTED. 

NOT EQUAL TO ZERO - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

THE OPERAND CANNOT BE FORWARD REFERENCED. 

# 9. 5. 2 . IFNZRO PSEUD-OP. 


IF THE OPERAND OF THE . IFNZRO IS: 

EQUAL TO ZERO - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

NOT EQUAL TO ZERO - ASSEMBLY IS UNAFFECTED. 

THE OPERAND CANNOT BE FORWARD REFERENCED. 


# 9. 5. 3 . IFDEF PSEUDO-OP. 


IF THE SYMBOL OPERAND OF THE . IFDEF IS: 

DEFINED - ASSEMBLY IS UNAFFECTED. 

NOT DEFINED - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

NOTE THAT . IFDEF WILL ACCEPT ONLY A SINGLE SYMBOL NAME AS THE 
OPERAND. 

A SYMBOL IS CONSIDERED TO BE DEFINED IF IT HAS BEEN USED IN THE 
LABEL FIELD OF A STATEMENT PRECEEDING THE CONDITIONAL PSEUDO-OP. 


# 9. 5. 4 . IFNDEF PSEUDO-OP. 


IF THE SYMBOL OPERAND OF THE . IFNDEF IS: 

DEFINED - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

NOT DEFINED - ASSEMBLY IS UNAFFECTED. 

NOTE THAT ONLY A SINGLE SYMBOL NAME IS ALLOWED AS THE OPERAND. 

A SYMBOL IS CONSIDERED TO BE DEFINED IF IT HAS BEEN USED IN THE 
LABEL FIELD OF A STATEMENT PRECEEDING THE CONDITIONAL PSEUDO-OP. 







# 9. 5. 5 . ENDC PSEUDO-OP. 


# 9 . 5 . 5 


THIS PSEUDO-OP INDICATES THE END 
EVERY CONDITIONAL PSUEDO-OP MUST 


OF A CONDITONAL ASSEMBLY GROUP. 
BE PAIRED WITH A . ENDC. 


# 9. 6. O . END PSEUDO-OP. 


THIS INDICATES THE END OF THE SOURCE PROGRAM. IT CANNOT HAVE EITHER 
A LABEL OR AN OPERAND. A WARNING MESSAGE WILL OCCUR IF THE . END 
STATEMENT IS LEFT OFF. 


#10. O. O ERROR MESSAGES AND WARNINGS. 


BOTH PASS #1 AND PASS #2 CAN GENERATE ERROR MESSAGES. THESE ARE 
PRINTED ON THE CONSOLE DEVICE AS THEY OCCUR. IF A LISTING IS 
SPECIFIED, PASS 3 WILL LIST THE ERROR MESSAGE ABOVE THE LINE IN 
WHICH THE ERROR OCCURS. 

ERROR MESSAGES WHICH ARE SENT TO THE CONSOLE HAVE THE FORM: 

E:XX AT LABEL+N 

WHERE "N 1 ’ IS A DECIMAL NUMBER OF 
LINES BEYOND THE STATEMENT WHICH 
CONTAINED THE GIVEN LABEL. IF NO 
LABEL WAS GIVEN, "N" IS THE NUMBER OF 
LINES FROM THE BEGINNING LINE OF THE 
PROGRAM. 

IF THE BINARY OUTPUT FILE IS SENT TO THE CONSOLE, AND ERROR 
MESSAGES OCCUR, THE OUTPUT FILE LINES AND ERROR MESSAGES WILL BE 
INTERMIXED. USE OF THE /E OPTION WILL INHIBIT THE ERROR MESSAGES 
TO THE CONSOLE SO THAT ONLY THE BINARY FILE IS OUTPUT. THIS IS 
USEFUL WHEN A USER WOULD LIKE TO TRY OUT CERTAIN PARTS OF A PROGRAM 
AND IS NOT YET CONCERNED WITH OTHER PARTS KNOWN TO HAVE ERRORS. 






# 10 . 0 . 0 


INDIVIDUAL ERROR MESSAGES ARE EXPLAINED IN TABLE #2 WHICH DIVIDES 
THE MESSAGES INTO THREE TYPES: 

1) FATAL ERRORS- THESE ERRORS CAUSE THE IMMEDIATE 
EXIT TO THE OS/8 MONITOR. THE CURRENT OUTPUT FILE 
IS NOT CLOSED. /E WILL NOT INHIBIT FATAL ERROR 
MESSAGES. FATAL ERROR MESSAGES ARE ALWAYS SENT TO 
THE CONSOLE DEVICE. 

2) WARNING MESSAGES INDICATE MINOR PROGRAM 
PROBLEMS. ASSEMBLY IS NOT HALTED. GOOD PROGRAMMING 
PRACTICES WILL ELIMINATE ALL WARNING MESSAGES. 

3) NON-FATAL ERRORS - THE OCCURANCE OF A NON-FATAL 
ERROR WILL NOT HALT ASSEMBLY. THE ASSEMBLER 
ATTEMPTS TO DO AS MUCH OF THE LINE AS POSSIBLE. FOR 
EXAMPLE, IF THE OPERAND CANNOT BE EVALUATED, IT 
GIVES IT A VALUE OF ZERO, WRITES THE ERROR MESSAGE 
AND CONTINUES. 



TABLE #2. 


#10. 0. 0 


*******************##*****■«■#•*###•*#**•#•■*••*•«■*'*******##*********#***•** 
**** FATAL ERRORS **** 

E:DF - DEVICE FULL: 

FILE #N THERE IS NOT ENOUGH ROOM LEFT ON THE OUTPUT DEVICE 

FOR THE FILE. "N" INDICATES WHICH OF THE TWO OUT¬ 
PUT FILES WAS IN ERROR. 

E:LT - LOCAL SYMBOL TABLE OVERFLOW: 

THIS ERROR OCCURS ONLY IF THE /K OPTION IS IN USE. 
CONVERSION OF SOME OF THE LOCAL SYMBOLS TO REGULAR 
SYMBOL NAMES WILL USUALLY SOLVE THIS PROBLEM. SEE 
THE NOTES ON THE /K RUN-TIME OPTION. 

E:OE - OPEN ERROR IN OUTPUT FILE: 

FILE #N AN ATTEMPT WAS MADE TO OPEN AN OUTPUT FILE ON AN 

INPUT-ONLY DEVIDE. (PTR:» CDR:, ETC.) "N" INDICATES 
WHICH ONE OF THE TWO POSSIBLE OUTPUT FILES WAS IN 
ERROR. 

E:PE - PHASE ERROR: 

A LOCATION TAG HAS A DIFFERENT ADDRESS IN ONE PASS 
THAN IT HAD IN THE PREVIOUS PASS. 

E:RE - READ ERROR: 

FILE #N AN ERROR HAS OCCURRED WHILE READING FROM AN INPUT 

FILE DEVICE. "N” INDICATES WHICH ONE OF THE NINE 
POSSIBLE INPUT FILES HAD THE ERROR. 

E:ST - SYMBOL TABLE OVERFLOW: 

THE PROGRAM IS TOO LARGE. WHERE CONVENIENT, DIVIDE 
IT AND ASSEMBLE EACH PART SEPARATELY. ALSO REFER TO 
THE NOTES ON THE /K RUN-TIME OPTION. 

E:WE - WRITE ERROR: 

FILE #N AN ERROR HAS OCCURRED WHILE WRITING TO AN OUTPUT 

FILE DEVICE. "N" INDICATES WHICH ONE OF THE TWO 
OUTPUT FILES HAD THE ERROR. 

•#■**■*• WARNING MESSAGES #**# 

W:EF - NO . END STATEMENT: 

THE LAST INPUT FILE MUST HAVE AN . END STATEMENT. 
THE ASSEMBLER PROCEEDS AS IF AN . END WERE PRESENT. 

W:UC - ASSEMBLY WAS CONDITIONALLY INHIBITED AT THE END OF 

THE PROGRAM: EACH CONDITIONAL ASSEMBLY PSEUDO-OF* 
MUST BE PAIRED WITH AN . ENDC STATEMENT. 





TABLE #2. (CONT. ) #10. O. 0 

*******##***#4HHt**#*#****#****#**##***************#**#*###*##*##* 

**** NON-FATAL ERRORS **** 

E:BN - BAD NESTING OF BRACKETS: 

EACH OPEN BRACKET MUST BE PAIRED WITH A CLOSED 
BRACKET. 

E: DR - DIGIT OUTSIDE OF RADIX: 

THE CONSTANT CONTAINS A DIGIT NOT RECOGNIZED UNDER 
THE SPECIFIED RADIX. FOR EXAMPLE, THE DIGIT “2" IS 
NOT RECOGNIZED IN BINARY RADIX. THE CONSTANT WILL 
BE EVALUATED AS IF THAT DIGIT WERE ZERO. 

E:IL - ILLEGAL LABEL FIELD: 

THE LABEL MAY NOT BE IN THE PROPER SYMBOL FORMAT, 
SEE SECTION #6. 2. 0 . ALSO, SOME PSEUDO-OPS CANNOT 
HAVE LABELS. 

E:10 - ILLEGAL OPERAND VALUE: 

REFER TO THE SECTION ON THE STATEMENT'S OPERATOR TO 
DETERMINE THE ALLOWABLE OPERAND TERMS. 

E: LO - LINE INPUT OVERFLOW: 

.ONLY 127 CHARACTERS, NOT INCLUDING THE CARRIAGE 
RETURN AND LINE FEED, ARE ALLOWED IN AN INPUT LINE. 

E:LS - LOCAL SYMBOL SYNTAX ERROR: 

THE CORRECT FORMAT FOR A LOCAL SYMBOL IS $N WHERE 
"N" IS A DECIMAL NUMBER FROM 0 TO 255. 

E: ML - MULTIPLE LABEL DEFINITION: 

THE SAME LABEL HAS A DIFFERENT VALUE AND IS USED 
WITH AN OPERATOR OTHER THAN A . SET PSEUDO-OP. 

E:MO - MISSING OR ILLEGAL MNEMONIC IN OPERATOR FIELD: 

E:OC - OPERAND TOO COMPLEX: 

TOO MANY TERMS AND OPERATORS EXIST IN THE OPERAND. 
DIVIDE THE EXPRESSION USING THE . SET COMMAND. 

EXAMPLE: THE FIRST EXPRESSION IS DIVIDED INTO THE 


TWO STATEMENTS 

FOLLOWING IT. 


WORD 

. EQU 

C EXPR1 3 •+• C EXPR2 3 

TEMP 

. SET 

t EXPR1 3 

WORD 

. EQU 

TEMP + C EXPR2 3 


E: OM - OPERAND MISSING. 





TABLE #2. (CONT. ) 


#10. 0. 0 


******************* -it#*#**#*#****#**####*##**#****#*************** 


E: OS - OPERAND SYNTAX ERROR. 

E:PS - ILLEGAL PERMANENT SYMBOL USAGE IN OPERAND: 

REFER TO THE APPENDICES TABLES TO SEE WHICH NAMES 
ARE USED IN THE ASSEMBLER AND MICROPROCESSOR IN¬ 
STRUCTION SETS AND RENAME YOUR SYMBOL SO THAT IT 
WILL NOT CONFLICT. 


E:TL - LABEL DEFINED TOO LATE: 

ONLY ONE LEVEL OF FORWARD REFERENCING IS ALLOWED. 


E:US - UNDEFINED SYMBOL: 




NOTE: REFER TO SECTION #12. O. 0 FOR ADDITIONAL ERROR MESSAGES WHICH 

ARE SPECIFIC TO THE TYPE OF MICROPROCESSOR BEING USED. 


#11. 0. 0 MODIFICATION NOTES. 


VARIOUS MODIFICATIONS CAN BE MADE TO THE ASSEMBLER FOR GREATER 
OPERATING CONVENIENCE. BEFORE MAKING ANY CHANGES, THE USER SHOULD 
READ THE DESCRIPTION OF EACH OPTION CAREFULLY. NO CHECKS ON PATCH 
VALIDITY ARE MADE. ALSO KEEP A RECORD OF ALL CHANGES SO THAT THE 
STATUS OF THE CROSS-ASSEMBLER IS ALWAYS KNOWN. 

MODIFICATIONS ARE MADE BY PATCHING LOCATIONS IN THE IMAGE (. SV) 
FILE USING ODT. REFER TO THE OS/S MANUAL FOR A DETAILED EXPLAN¬ 
ATION OF ODT OPERATION. 

THE EXAMPLE BELOW SHOWS AN ODT PATCH BEING MADE TO FILE "XNAME. SV” 
WHERE THE CONTENT OF LOCATION 10107 IS CHANGED FROM 3 TO 2. 

. GET SYS: XNAME 
. ODT 

10107/0003 2 
•■'C 

. SA SYS:XNAME 




# 11 . 1 . 0 


#11. 1. 0 CHANGING THE DEFAULT INPUT FILE EXTENSION (.MS). 


PATCH LOCATION 10100 TO CONTAIN THE NEW 2 CHARACTER 6 BIT ASCII 
EXTENSION. 


#11.2.0 CHANGING THE DEFAULT BINARY OUTPUT FILE EXTENSION (.MB) 


PATCH LOCATION 10101 TO CONTAIN THE NEW 2 CHARACTER 6 BIT ASCII 
EXTENSION. 


#11.3.0 CHANGING THE DEFAULT LISTING OUTPUT FILE EXTENSION (.LS). 


PATCH LOCATION 10102 TO CONTAIN THE NEW 2 CHARACTER 6 BIT ASCII 
EXTENSION. 


#11. 4. 0 CHANGING THE BASE YEAR DATE. 


IN OS/8 ONLY 3 BITS ARE PROVIDED TO INDICATE THE CURRENT YEAR. 
THIS ALLOWS ONLY NUMBERS FROM O TO 7 WHICH MUST BE ADDED TO A BASE 
YEAR TO FORM THE ACTUAL YEAR NUMBER. IN 1978 AND AT ADDITIONAL 8 
YEAR INTERVALS THE BASE YEAR MUST BE CHANGED TO PROVIDE THE PROPER 
DATE PRINTOUT. TO DO THIS, PATCH LOCATION 10104 TO CONTAIN THE TWO 
CHARACTER 6 BIT ASCII REPRESENTATION OF THE TWO LEAST SIGNIFICANT 
DIGITS OF THE YEAR. 


BASE YEAR: 
1978 
1986 
1994 
2002 


PATCH TO LOCATION 10104 (IN OCTAL). 
6770 
7066 
7164 
6062 


SHOULD THIS PROGRAM SURVIVE UNTIL THE YEAR 2000 THE TWO MOST 
SIGNIFICANT DIGITS MAY BE CHANGED BY PATCHING LOCATION 10103 TO 
CONTAIN 6260. 





#11. 5. O 


#11.5.0 CHANGING THE DEFAULT RADIX. (HEXADECIMAL) 


INITIALLY THE DEFAULT RADIX IS SET TO HEXADECIMAL. THIS MAY BE 
MODIFIED TO BINARY, OCTAL, OR DECIMAL BY PATCHING LOCATION 10105 
FROM THE FOLLOWING TABLE. 


RADIX: 


PATCH LOCATION 10105 TO: 


OCTAL 1 
HEXADECIMAL 2 
DECIMAL 3 
BINARY 4 


#11.6.0 GENERATING 8 BIT ASCII CHARACTERS WITHIN THE BINARY 
PROGRAM. 


THE ASCII CHARACTERS GENERATED AS OPERANDS WITH THE QUOTE 
CHARACTERS ARE SEVEN BIT REPRESENTATIONS TYPICAL OF MOST 
MICROPROCESSOR SYSTEMS. TO GENERATE EIGHT BIT ASCII WITH THE 
EIGHTH BIT ALWAYS SET (AS IS DONE IN SOME PDP8 SOFTWARE), PATCH 
LOCATION 10106 TO CONTAIN 377. (ORIGINAL CONTENT WAS 177). 


#11. 7. 0 RUNNING UNDER OSS VERSION 2. 


THE CROSS-ASSEMBLER IS SET UP TO USE THE OS/8 VERSION 3 METHOD FOR 
CORE SIZE DETERMINATION. IN OS/8 V3 THE CORE SIZE IS CONTAINED IN 
A MONITOR LOCATION. IN PREVIOUS VERSIONS, THE CORE SIZE MUST BE 
DETERMINED BY ACCESSING EACH FIELD OF MEMORY TO SEE IF IT EXISTS ON 
THE SYSTEM. THEREFORE , TO RUN THE CROSS-ASSEMLER UNDER VERSION 2, 
PATCH LOCATION 10107 TO CONTAIN 2. (ORIGINAL CONTENT WAS 3). 


#11.8.0 CHANGING THE NUMBER OF LINES PER PAGE. (6) 


THE NORMAL NUMBER OF LINES PER PAGE IS SET AT 66. 6 OF THE 66 
LINES ARE USED BY THE ASSEMBLER FOR THE HEADING AND MARGIN. TO 
ALTER THE NUMBER OF LINES ON A PAGE, PATCH LOCATION 10110 TO BE THE 
TOTAL POSITIVE LINES PER PAGE INCLUDING HEADING AND MARGIN. 







#11. 9. 0 


#11.9.0 CHANGING THE NUMBER OF CHARACTERS PER LINE. (72) 


THE TOTAL NUMBER OF CHARACTERS PRINTED ON ONE LINE (EXCLUDING 
CARRIAGE RETURN AND LINE FEED) IS SET AT 72 (BASE 10). TO MODIFY 
THIS COUNT, PATCH LOCATION 10111 TO CONTAIN THE POSITIVE NUMBER OF 
CHARACTERS TO BE PRINTED ON A LINE (EXCLUDING THE CR AND LF). 


#11. 10.0 INITIAL FORM/FEED CONTROL. 


SOME LINE PRINTER HANDLERS WHEN FIRST INITIALIZED WILL ISSUE AN 
AUTOMATIC FORM FEED. TO AVOID EJECTING AN ADDITIONAL PAGE EACH TIME 
THE ASSEMBLER IS CALLED, THE FIRST FORM FEED FROM THE HEADING HAS 
BEEN SUPPRESSED. TO REENABLE THIS FIRST FORM FEED, PATCH LOCATION 
10112 WITH 214 (BASE 8). 


#11. 11. 0 CHANGING LABEL DELIMINATOR (, ). 


TO PROVIDE COMPATIBILITY WITH OTHER ASSEMBLER FORMATS AN OPTIONAL 
LABEL DELIMITER WILL BE ACCEPTED. NORMALLY, THIS DELIMITER IS A 
COMMA, BUT IT CAN BE MODIFIED TO ANY OTHER NON-ALPHANUMERIC 
CHARACTER (EXCEPT THE SEMICOLON OR CARRIAGE RETURN). TO MODIFY THE 
DELIMITING CHARACTER PATCH LOCATION 10113 WITH THE 8 BIT ASCII 
VALUE FOR THE CHARACTER. 


#11. 12. 0 CHANGING FROM 8 BIT TO 7 BIT ASCII IN THE OUTPUT FILES. 


ALL ASCII OUTPUT TO THE BINARY (OBJECT) AND LISTING FILES IS IN 8 
BIT ASCII FORMAT. TO OUTPUT 7 BIT ASCII FORMAT PATCH LOCATION 10114 
TO CONTAIN 177. (ORIGINAL CONTENT WAS 377). 







#11. 13.0 CHANGING THE SENSE OF THE RUN-TIME OPTIONS. 


#11. 13. 0 


EACH SLASH OPTION (EXCEPT /O TO /9) MAY HAVE ITS SENSE INVERTED BY 
PATCHING THE LOCATIONS SHOWN IN THE FOLLOWING TABLE WITH THE 
DESCRIBED VALUE. 


OPTION: 


LOCATION: STANDARD: 


INVERTED: 


/B 

10116 

7650 

7640 

/E 

10117 

7640 

7650 

/H 

10120 

7650 

7640 

/J 

10121 

7650 

7640 

/K 

10122 

7650 

7640 

/L 

10123 

0 

1 

/N 

10124 

7650 

7640 

/O 

10125 

7650 

7640 

/P 

10126 

7640 

7650 

/S 

10127 

7650 

7640 

/T 

10130 

7650 

7640 

/W 

10131 

7650 

7640 





#12. 0. 0 F8 CROSS-ASSEMBLER SPECIFICS: 


# 12 . 0 . 0 


THE FIRST ELEVEN SECTIONS OF THIS MANUAL HAVE PRESENTED SIERRA 
DIGITAL'S UNIVERSAL ASSEMBLER FORMAT AS IT IS APPLIED TO ALL 
CROSS-ASSEMBLERS IN THE X8 SERIES. THIS SECTION PRESENTS 
ADDITIONAL INFORMATION ON THE APPLICATION OF THE UNIVERSAL 
ASSEMBLER FORMAT TO A SPECIFIC CROSS-ASSEMBLER FOR THE F8 
MICROPROCESSOR. THE F8 MICROPROCESSOR WAS DESIGNED BY FAIRCHILD 
MICRO SYSTEMS, 1725 TECHNOLOGY DRIVE, SAN JOSE, CALIFORNIA 95110. 
THE F8 IS PRODUCED BY FAIRCHILD MICRO SYSTEMS AND ALSO SECOND 
SOURCED BY MOSTEK CORPORATION, 1215 WEST CROSBY ROAD, CARROLLTON, 
TEXAS 75006. NO ATTEMPT WILL BE MADE IN THIS MANUAL TO EXPLAIN THE 
OPERATION OF THE MICROPROCESSOR. EXCELLENT MANUALS COVERING THE 
OPERATION OF THE MICROPROCESSORS ARE AVAILABLE FROM THEIR 
MANUFACTURERS. SECTION #13 PRESENTS A SUMMARY OF THE INSTRUCTION 
MNEMONIC CODES DEFINED BY FAIRCHILD AND RECOGNIZED BY OUR 
CROSS-ASSEMBLER. 


#12. 1.0 CROSS-ASSEMBLER FILE NAMES. 


THE CROSS-ASSEMBLER IS PROVIDED ON FILE STRUCTURED MEDIA UNDER THE 
NAMES: 


XF8. SV - FOR THE OS/8 SAVE IMAGE FILE 
XF8, BN - FOR THE OS/8 BINARY FORMAT FILE 

IT IS SUGGESTED THAT THE SAME NAMING CONVENTIONS BE USED WHEN 
LOADING THE CROSS-ASSEMBLER FROM PAPER TAPE. 


#12. 2. 0 TIMER COUNT OPERATOR. 


AN ADDITIONAL UNARY OPERATOR HAS BEEN PROVIDED TO PERFORM TIMER 
COUNT CONVERSIONS FOR THE PROGRAMMABLE CLOCKS CONTAINED IN THE 3851 
PSU CHIP AND THE 3853 SMI CHIP. THE CLOCKS CONTAIN POLYNOMIAL 
SHIFT REGISTERS RATHER THAN BINARY COUNTERS AND THEREFORE THE 
ACTUAL NUMBER LOADED TO THE CLOCK TO PERFORM A COUNT IS DIFFERENT 
FROM THE DESIRED COUNT. THE UNARY OPERATOR A T (UPARROW T) WILL 
CONVERT THE FOLLOWING OPERAND TO A NUMBER REQUIRED BY THE CLOCK TO 
GENERATE THE DESIRED NUMBER OF TIMER COUNTS. 

EXAMPLE: 


LI -T"D20 iLOAD TIMER CONSTANT FOR 20 COUNTS 

OUTS 7 i OUTPUT TO TIMER 


THE VALUE ACTUALLY SENT TO THE TIMER IS OF (HEX). 






#12. 3. 0 


#12. 3. 0 PREASSIGNED SYMBOLS. 


THE FOLLOWING THREE SYMBOLS HAVE BEEN ASSIGNED THE VALUES SHOWN AND 
ARE TYPICALLY USED TO INDICATE INDIRECT ADDRESSING OF SCRATCHPAD 
REGISTERS THROUGH THE ISAR. 


SYMBOL 

VALUE 

USAGE 


S 

DC 

INDIRECTLY ADDRESS SCRATCHPAD 

REGISTER. 

I 

OD 

INDIRECTLY ADDRESS SCRATCHPAD 
AND INCREMENT LOWER 3 BITS OF 

REGISTER 

ISAR. 

D 

OE 

INDIRECTLY ADDRESS SCRATCHPAD 
AND DECREMENT LOWER 3 BITS OF 

REGISTER 

ISAR. 


THE FOLLOWING TABLE CONTAINS SYMBOLS WHICH HAVE A SPECIAL MEANING 
WHEN USED WITH 'LR-' OPERATOR. ALTHOUGH THESE SYMBOLS HAVE NOT BEEN 
RESERVED IT IS SUGGESTED THAT THEIR USAGE BE RESTRICTED TO THE 'LR-' 
INSTRUCTION. 

SYMBOL MEANING 


A 

ACCUMULATOR 


DC 

DATA COUNTER 


H 

REGISTERS 10 AND 

11 

IS 

INDIRECT SCRATCHPAD ADDRESS REGISTER 

J 

REGISTER 9 


K 

REGISTERS 12 AND 

13 

KL 

REGISTER 13 


KU 

REGISTER 12 


P 

STACK REGISTER 


PO 

PROGRAM COUNTER 


Q 

REGISTERS 14 AND 

15 

QL 

REGISTER 15 


QU 

REGISTER 14 


W 

STATUS REGISTER 





#12. 4. 0 LISTING FORMAT. 


#12. 4. 0 


THE LISTING FILE IS OUTPUT WITH THE OBJECT CODE PRINTED TO THE LEFT 
OF THE SOURCE CODE LINES. AS EACH MICROPROCESSOR INSTRUCTION MAY 
CODE INTO ONE, TWO, OR THREE BYTES, ROOM IS PROVIDED FOR THREE 
COLUMNS OF GENERATED OBJECT CODE PLUS A COLUMN FOR THE ADDRESS. THE 
ADDRESS AND OBJECT CODE ARE NORMALLY PRINTED IN HEXADECIMAL BUT 
THIS MAY BE CHANGED TO OCTAL WITH THE /O COMMAND DECODER OPTION. 
SOURCE LINES WHICH EXCEED THE PRINTOUT LIMIT WILL BE CONTINUED AT 
COLUMN 25 (STANDARD COMMENT TAB STOP) OF THE SOURCE PRINTOUT 
POSITION. TABS OCCURING IN THE SOURCE PROGRAM ARE CONVERTED TO THE 
Proper NUMBER OF BLANK CHARACTERS BY THE ASSEMBLER. THIS IS DONE 
BY THE ASSEMBLER RATHER THAN THE DEVICE HANDLER OR DEVICE BECAUSE 
THE BEGINNING OF THE SOURCE PRINTOUT DOES NOT OCCUR ON A STANDARD 
TAB STOP. 


#12. 5. 0 BINARY FILE OUTPUT. 


THE BINARY OR OBJECT OUTPUT MAY BE SELECTED FROM ONE OF THREE 
FORMATS. WITH NO OPTION SPECIFIED THE OUTPUT WILL DEFAULT TO 
FAIRCHILD'S FORMULATOR FORMAT FOR USE WITH THEIR FORMULATGR 
DEVELOPEMENT SYSTEM. THE FORMULATOR FORMAT IS DESCRIBED IN SECTION 
#12. 5. 1. AN ALTERNATE FORMAT SPECIFIED BY FAIRCHILD IS THEIR 
FAIR-BUG OUTPUT WHICH IS USED BY THEIR SMALLER F8S EVALUATION 
MODULE. THE FAIR-BUG FORMAT IS DESCRIBED IN SECTION #12. 5. 2 AND 
MAY BE SELECTED BY SPECIFING /F TO THE COMMAND DECODER AT ASSEMBLY 
INITIATION TIME. THE THIRD TYPE OF BINARY OUTPUT IS BNPF WHICH MAY 
BE SELECTED BY A /B RUN-TME OPTION. SECTION #2. 4. 0 DESCRIBES THE 
BNPF OUTPUT. 





#12. 5. 1 


#12. 5. 1 FORMULATQR FORMAT. 


THE OBJECT (BINARY) OUTPUT FILE CONSISTS OF ASCII TEXT REPRESENTING 
HEXADECIMAL NUMBERS IN THE FOLLOWING FORMAT: 

LEADER STRINGS OF 100 NULL CHARACTERS PRECEED AND FOLLOW THE OBJECT 
OUTPUT. EACH LINE BEGINS WITH A COLON AND IS FOLLOWED BY A TWO HEX 
DIGIT BYTE COUNT, A FOUR HEX DIGIT ADDRESS, A TWO HEX DIGIT RECORD 
TYPE (ALWAYS 0), UP TO 16 BYTES OF DATA (EACH 2 HEX DIGITS), AND A 
TWO HEX DIGIT CHECKSUM. AT THE END OF EACH LINE IS A CARRIAGE 
RETURN, LINE FEED, NULL, AND READER OFF. 

EXAMPLE: 

: CCAAAATTDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDSS 
WHERE: 

CC IS THE TWO HEXADECIMAL DIGIT COUNT FOR THE NUMBER OF 
DATA BYTES (REPRESENTED BY PAIRS OF D'S) IN THE LINE. 
A COUNT OF ZERO INDICATES THE TERMINATION OF THE OBJECT 
OUTPUT. THE TERMINATING LINE WILL ALSO HAVE A ZERO 
ADDRESS, TYPE ENTRY, AND CHECKSUM (:0000000000). 

AAAA IS THE HEXADECIMAL ADDRESS FOR STORING THE FIRST DATA 
BYTE. EACH ADDITIONAL DATA BYTE IS TO BE STORED IN 
SEQUENTIAL ADDRESSES. THE ADDRESS IS PRESENTED WITH ITS 
MOST SIGNIFICANT BYTE FIRST. 

TT IS THE 2 HEXADECIMAL DIGIT RECORD TYPE. THIS INDICATOR 
IS CURRENTLY UNUSED AND ASSIGNED A VALUE OF 00. 

DD REPRESENTS TWO HEXADECIMAL DIGITS FOR A BYTE OF OBJECT 
(BINARY) CODE UP TO 16 BYTES MAY BE OUTPUT ON ONE 

LINE. 

SS IS THE TWO HEXADECIMAL DIGIT CHECKSUM OF THE LINE. ALL 
EIGHT BIT BYTES IN THE LINE AFTER THE RECORD MARK ( ': ' ) 
ARE SUMMED. THE LEAST SIGNIFICANT BYTE OF THE NEGATIVE 
OF THIS VALUE IS THE CHECKSUM. THUS IF ALL BYTES IN 

THE LINE ARE ADDED TOGETHER WITH CARRYS IGNORED, AND 
THIS SUM IS ADDED TO THE CHECKSUM, THE RESULT WILL BE 
ZERO. 


THE 'READER OFF'' CHARACTER AT THE END OF EACH OBJECT CODE LINE MAY 
BE UNDESIRABLE WHEN THE BINARY OUTPUT IS NOT PUNCHED ON PAPER TAPE. 
THE 'READER OFF-' CHARACTER IS STORED AT LOCATION 10134 AND MAY BE 
PATCHED TO NULL (0). 




#12. 5. 2 FAIFMBUG FORMAT. 


#12. 5. 2 


THE OBJECT (BINARY) OUTPUT FILE CONSISTS OF ASCII TEXT REPRESENTING 
HEXADECIMAL NUMBERS IN THE FOLLOWING FORMAT. LEADER STRINGS OF 
ASTERISKS PRECEDE AND FOLLOW THE OBJECT OUTPUT. THE STARTING 
ADDRESS OF A SECTION OF OUTPUT IS INDICATED BY A LINE CONTAINING AN 
'S' FOLLOWED BY A FOUR HEXADECIMAL DIGIT ADDRESS. THE DATA THEN 
FOLLOWS ON LINES CONTAINING AN 'X'. EIGHT 2 HEXADECIMAL DIGIT DATA 
BYTES AND ONE HEXADECIMAL DIGIT CHECKSUM CHARACTER. 

EXAMPLE: 


SAAAA 

X DDDDDDDDDDDDDDDDS 
WHERE: 


AAAA IS THE HEXADECIMAL ADDRESS FOR STORING THE FIRST 

DATA BYTE. EACH ADDITIONAL DATA BYTE IS TO BE STORED 
IN SEQUENTIAL ADDRESSES. 

DD REPRESENTS TWO HEXADECIMAL DIGITS FOR A BYTE OF 

OBJECT (BINARY) CODE. EIGHT BYTES ARE ALWAYS OUTPUT 
ON A LINE WITH UNSPECIFIED BYTES BEING ZERO. 

S IS A SINGLE HEXADECIMAL DIGIT CHECKSUM. THE CHECKSUM 

CONSISTS OF THE SUM OF EACH INDIVIDUAL HEXADECIMAL 
DIGIT IN THE LINE OF DATA CHARACTERS TRUNCATED TO 
THE LEAST SIGNIFICANT FOUR BITS. 


EXAMPLE: 


SI 000 

X495E4C59700B4C178 
XOA1F251094F816502 
X 20E78E08001701176 
X71B4A4212094190EF 
XA42106250220A484C 
X0B768108A4210220E 
XEA9402502911D0291 


THE SENSE OF THE /F OPTION MAY BE INVERTED BY PATCHING 
10133 TO CONTAIN 7640. 


LOCATION 



#12. 6. 0 ADDITIONAL ERROR MESSAGES FOR THE XF8. 


#12. 6. O 


STANDARD ERRORS: 

E:RV BAD REGISTER VALUE FIELD. 

THE VALUE ASSIGNED TO A REGISTER SPECIFICATION FIELD DID 

NOT MATCH ONE OF THE ALLOWABLE VALUES FOR THE 

INSTRUCTION. 

E: BR BRANCH IS OUT OF RANGE. 

THE OPRAND ADDRESSS WAS OUT OF RANGE FROM THE REQUIRED 

-128 TO +127 (DECIMAL) BYTES FROM THE SECOND BYTE OF THE 

BRANCH INSTRUCTION. 




#12. 7. 0 


*12. 7. O SAMPLE PROGRAM 


R XF8 

*TTY:,TTY:CSAMPLE/O/P/J 
E:MO AT MSG + 5 

E: MO AT MSG + 5 

1010000071B0B8B920A4502A1050708884075128B4 
10101000103490F7281020250084FF28103490F514 
10102000A991FE7F181F94FEAS185171B9A981FEDD 
1010300070B9411C7A5270B0402BBBBBBB240194E9 
1O104000FA32840C412101B0411224805190EA1CF3 
0810500053544152548D8A00F3 
0000000000 


AMPLE F: 

3 ROUTINE 


NOV 

1, 1976 XF8-V1A PAGE 1 





. TITLE 

SAMPLE 

F8 ROUTINE 




} 

SELECT 

/O FOR 

300 BAUD St 10 BIT 




i 

THIS ROUTINE READS DATA FROM A HIGH SPEED 




i 

READER 

AND PRINTS IT ON A TELETYPE. 


0 

0 

BAUD 

. EQU 

0 

i REGISTER FOR BAUD RATE COUNT 


0 

1 

CHRS 

. EQU 

1 

; REGISTER FOR CHARACTER 


0 

'”7 

BCNT 

. EQU 

2 

; REGISTER FOR BIT COUNT 


10 

0 


. ORG 

1000 


1000 

71 


START 

LIS 

1 


1001 

BO 



OUTS 

0 

; INIT TTY-PORT TO MARK STATE 

1002 

B8 



OUTS 

8 

i INITIALIZE READER PORT 

1003 

B9 



OUTS 

9 

; INITIALIZE READER CONTROL 

1004 

20 

A4 


LI 

6*11 r ~? 

03 ! -""D 164*?0 ; SELECT 110 OR 300 

1006 

50 



LR 

BAUD, A 

; BAUD FOR TTY 

1007 

2A 

10 50 


DC I 

MSG 

; SET DATA COUNTER FOR MESSAGE 

1OOA 

70 


*1 

CLR 



100B 

88 



AM 


; GET MESSAGE CHARACTER 

1OOC 

84 

7 


BZ 

$2 

; TERMINATE ON ZERO CHARACTER 

100E 

51 



LR 

CHRS, A 


100F 

28 

10 34 


PI 

TTYOUT 

; OUTPUT CHARACTER 

1012 

90 

F7 


BR 

$1 

i TRY NEXT CHARACTER 

1014 

28 

10 20 

$2 

PI 

GCHAR 

; GET CHARACTER FROM READER 

1017 

25 

0 


Cl 

0 


1019 

84 

FF 

$3 

BZ 

S3 

;HANG HERE WHEN DONE 

10 IB 

28 

10 34 


PI 

TTYOUT 

;OUTPUT CHARACTER TO TTY 

10 IE 

90 

F5 


BR 

$2 

;TRY NEXT CHARACTER 

1020 

A 9 


GCHAR 

INS 

9 

j GET A READER CHARACTER 

1021 

91 

FE 


BM 

GCHAR 

;LOOK FOR SPROCKET = HIGH 

1023 

7F 



LIS 

•'•D15 

; 100US DELAY AFTER SPROCKET 

1024 

18 



COM 



1025 

IF 


$1 

INC 



1026 

94 

FE 


BNZ 

SI 


1028 

AS 



INS 

8 

j NOW GET THE DATA BYTE 

1029 

18 



COM 



102A 

51 



LR 

CHRS, A 

i TEMP STORE NEW CHAR 

102B 

71 



LIS 

1 

; ADVANCE THE READER 

102C 

B9 



OUTS 

9 


102D 

A9 


S2 

INS 

9 

; GET READER STATUS 

102E 

81 

FE 


BP 

S2 

;LOOK FOR MOVING OFF SPROCKET 

1030 

70 



LIS 

0 


1031 

B9 



OUTS 

9 

iREMOVE DRIVE PULSE 

1032 

41 



LR 

A, CHRS 

; PICK UP NEW CHAR 

1033 

1C 



POP 
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SAMPLE FS ROUTINE NOV 1, 1976 XF8-V1A PAGE 


. PAGE 

TTY OUTPUT ROUTINE 


1034 

7A 


TTYOUT 

LIS 

OB—?0 

}/0 OPTION CAUSES 10 BIT 

FORMAT 

1035 

52 



LR 

BCNT ,A 

;SET BIT COUNT FOR 10 OR 

11 

1036 

70 



LIS 

0 



1037 

BO 



OUTS 

0 

;OUTPUT START BIT 






DELAY 3- 

3MS FOR 

300 BAUD, 9. 09MS FOR 110 

BAUD 

1038 

40 


*1 

LR 

A, BAUD 

;GET DELAY COUNT 


1039 

2B 



NOP 




103A 

BB 


*2 

OUTS 

OB 

iNOP FOR DELAY (36US PER 

LOOP) 

103B 

BB 



OUTS 

OB 



103C 

BB 



OUTS 

OB 



103D 

24 

1 


AI 

1 

iINCR WITH A 5US INST 


103F 

94 

FA 


BNZ 

$2 



1041 

32 



DS 

BCNT 

i DECREMENT BIT COUNT 


1042 

84 

c 


BZ 

$3 

;DONE WITH ALL BITS 


1044 

41 



LR 

A, CHRS 

;GET CHARACTER 


1045 

21 

1 


NI 

1 

;MASK OFF ALL BUT BIT 0 


1047 

BO 



OUTS 

0 

;OUTPUT THE NEW DATA BIT 


1048 

41 



LR 

A, CHRS 

;SHIFT THE CHAR FOR NEXT 

BIT 

1049 

12 



SR 

1 



104A 

24 

80 


AI 

"B10000000 ; FILL WITH l'S FOR STOP BITS 

104C 

51 



LR 

CHRS, A 



104D 

90 

EA 


BR 

*1 

i DELAY AGAIN 


104F 

1C 


$3 

POP 


i ALL FINISHED 






. IFZERO 

?1 

;SELECT THIS MESSAGE BY DEFAULT 

1050 

53 


MSG 

. BYTE 

"START", 

•-•0215, •'•■0212, 0 


1051 

54 







1052 

41 







1053 

52 







1054 

54 







1055 

8D 







1056 

8A 







1057 

0 











. ENDC 








. IFNZRO 

?1 

;SELECTED BY /I RUNTIME OPTION 




MSG 

. BYTE 

"TURN OK 

READER", •■••0215, "•0212, 0 






. ENDC 




###### 

E: MO 










JUNK 


>SAMPLE ERROR 






. END 





AMPLE F8 ROUTINE 



NOV 

1, 1976 

XF8-V1A 

PAGE 

0 BAUD 

1050 MSG 

2 

1000 

BCNT 

START 

1 

1034 

CHRS 

TTYOUT 

1020 GCHAR 



ERRORS: 1 
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#13. 0. 0 MICROPROCESSER INSTRUCTION SET: 


THIS SECTION IS A SUMMARY OF THE INSTRUCTION SET OF THE F8 
MICROPROCESSOR AS DEFINED BY THE VENDORS. THE ASSEMBLY CODE FORMAT 
FOR EACH INSTRUCTION IS SHOWN WITH THE HEXADECIMAL OBJECT CODE. 
EACH INSTRUCTION WILL BE CODED INTO THE DESIGNATED NUMBER OF BYTES. 


ACCUMULATOR GROUP INSTRUCTIONS: 


INSTRUCTION MEANING HEX CODE BYTES 


AI 

DATA8 

ADD IMMEDIATE DATA 

24 

2 

Cl 

DATA8 

COMPARE IMMEDIATE DATA 

25 

2 

CLR 


CLEAR ACCUMULATOR 

70 

i 

COM 


COMPLEMENT ACCUMULATOR 

18 

i 

INC 


INCREMENT ACCUMULATOR 

IF 

i 

LI 

DATA8 

LOAD IMMEDIATE DATA 

20 

2 

LIS 

DATA4 

LOAD IMMEDIATE SHORT 

70+DATA 

i 

LNK 


LINK CARRY TO ACCUMULATOR 

19 

i 

NI 

DATAS 

AND IMMEDIATE DATA 

21 

2 

01 

DATA8 

OR IMMEDIATE DATA 

22 

2 

SL 

1 

SHIFT LEFT ONE 

13 

i 

SL 

4 

SHIFT LEFT FOUR 

15 

i 

SR 

1 

SHIFT RIGHT ONE 

12 

i 

SR 

4 

SHIFT RIGHT FOUR 

14 

i 

XI 

DATAS 

EXCLUSIVE OR IMMEDIATE DATA 

23 

7 

•Am* 


DATA8 

REPRESENTS AN 8 BIT DATA QUANTITY. 




DATA4 

REPRESENTS A 4 BIT DATA QUANTITY. 









#13. 0. 0 

SCRATCHPAD REGISTER INSTRUCTIONS: 


INSTRUCTION MEANING HEX CODE BYTES 


AS 

R 

BINARY ADDITION OF REGISTER 

CO+R 

1 

ASD 

R 

DECIMAL ADDITION OF REGISTER 

DO+R 

1 

DS 

R 

DECREMENT REGISTER 


30+R 

1 

LR 

A, R 

LOAD 

ACC FROM 

REGISTER 

R 

40+R 

1 

LR 

A/ KU 

LOAD 

ACC FROM 

REGISTER 

12 

00 

1 

LR 

A/ KL 

LOAD 

ACC FROM 

REGISTER 

13 

01 

1 

LR 

A> QU 

LOAD 

ACC FROM 

REGISTER 

14 

02 

1 

LR 

A/ QL 

LOAD 

ACC FROM 

REGISTER 

15 

03 

1 

LR 

R, A 

LOAD 

REGISTER 

R FROM 

ACC 

50+R 

1 

LR 

KU/ A 

LOAD 

REGISTER 

12 FROM 

ACC 

04 

1 

LR 

KL/ A 

LOAD 

REGISTER 

13 FROM 

ACC 

05 

1 

LR 

QU, A 

LOAD 

REGISTER 

14 FROM 

ACC 

06 

1 

LR 

QL/ A 

LOAD 

REGISTER 

15 FROM 

ACC 

07 

1 

NS 

R 

LOGICAL AND ACC WITH REG. R 

FO+R 

1 

XS 

R 

EXCLUSIVE OR ACC WITH 

REG. R 

EO+R 

1 


R VALUES 
0 TO 

12 OR 

13 OR 

14 OR 


HAVE THE FOLLOWING MEANING: 

11 (DECIMAL) - DIRECT REGISTER ADDRESSING 
S - SCRATCHPAD ADDRESS SUPPLIED BY ISAR 

I - SCRATCHPAD ADDRESS SUPPLIED BY ISAR 

ISAR IS INCREMENTED AFTER INSTRUCTION 
D - SCRATCHPAD ADDRESS SUPPLIED BY ISAR 

ISAR IS DECREMENTED AFTER INSTRUCTION 


DATA COUNTER INSTRUCTIONS: 


INSTRUCTION MEANING 


HEX CODE BYTES 


ADC 


ADD ACCUMULATOR TO DATA COUNTER 

8E 

1 

DC I 

DATA16 

LOAD 

DATA COUNTER IMMEDIATE 

2 A 

3 

LR 

Q/ DC 

LOAD 

LOCATIONS Q FROM DATA COUNTER 

OE 

1 

LR 

H, DC 

LOAD 

LOCATIONS H FROM DATA COUNTER 

11 

1 

LR 

DC/ Q 

LOAD 

DATA COUNTER FROM LOCATIONS Q 

OF 

1 

LR 

DC/ H 

LOAD 

DATA COUNTER FROM LOCATIONS H 

10 

1 

XDC 


EXCHANGE DATA COUNTERS 

2C 

1 


DATA16 REPRESENTS A 16 BIT DATA QUANTITY. 






#13. 0. 0 


INDIRECT SCRATCHPAD ADDRESS REGISTER INSTRUCTIONS: 
INSTRUCTION MEANING HEX CODE BYTES 


LR 

A/ IS 

LOAD 

ACCUMULATOR FROM ISAR 

OA 

1 

LR 

IS/ A 

LOAD 

ISAR 

FROM ACCUMULATOR 

OB 

1 

LISU 

DATA3 

LOAD 

DATA 

TO ISAR UPPER DIGIT 

60+DATA 

1 

LISL 

DATA3 

LOAD 

DATA 

TO ISAR LOWER DIGIT 

68+DATA 

1 


DAT A3 REPRESENTS A 3 BIT DATA QUANTITY. 


MEMORY REFERENCE INSTRUCTIONS: 


INSTRUCTIONS 


MEANING 


HEX CODE BYTES 


ADD MEMORY TO ACCUMULATOR/ BINARY 
ADD MEMORY TO ACCUMULATOR/ DECIMAL 
COMPARE MEMORY TO ACCUMULATOR 
LOAD ACCUMULATOR FROM MEMORY 
LOGICAL AND MEMORY WITH ACCUMULATOR 
LOGICAL OR MEMORY WITH ACCUMULATOR 
STORE ACCUMULATOR IN MEMORY 
EXCLUSIVE OR MEMORY WITH ACCUMULATOR 


MEMORY LOCATION IS DESIGNATED BY THE DATA COUNTER. 


STATUS REGISTER INSTRUCTIONS: 


INSTRUCTION 


MEANING 


HEX CODE BYTES 


LR 

LR 


W/ J 
J/ W 


LOAD W FROM REGISTER 9 
LOAD REGISTER 9 FROM W 


ID 

IE 


1 

1 
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PROGRAM COUNTER INSTRUCTIONS: 


INSTRUCTION 

MEANING HEX 

CODE 

BYTES 

LR 

K, P 

LOAD 

K REGISTERS FROM THE STACK REG. 

08 

1 

LR 

P, K 

LOAD 

THE STACK REG. FROM THE K REG. 

09 

1 

LR 

PO, Q 

LOAD 

PROGRAM COUNTER FROM THE Q REG. 

OD 

1 

PI 

ADDR 

CALL 

TO SUBROUTINE IMMEDIATE 

28 

3 

PK 


CALL 

TO SUBROUTINE DIRECT 

OC 

1 

POP 


RETURN FROM SUBROUTINE 

1C 

1 

JMP 

ADDR 

BRANCH IMMEDIATE 

29 

•~r 

_ 







ADDR REPRESENTS A 16 BIT ADDRESS QUANTITY. 




BRANCH 

INSTRUCTIONS: 



INSTRUCTION 

MEANING 


HEX CODE 

BYTES 

BR 

ADDR 

UNCONDITIONAL BRANCH 

90 


BT 

T, ADDR 

CONDITIONAL BRANCH TRUE 

80+T 

.y 

BP 

ADDR 

BRANCH 

IF 

POSITIVE 

81 

2 

BC 

ADDR 

BRANCH 

ON 

CARRY 

82 

• 7 / 

BZ 

ADDR 

BRANCH 

ON 

ZERO 

84 

2 

BM 

ADDR 

BRANCH 

ON 

NEGATIVE 

91 

2 

BNC 

ADDR 

BRANCH 

IF 

NO CARRY 

92 

2 

BNZ 

ADDR 

BRANCH 

IF 

NOT ZERO 

94 

2 . 

BR7 

ADDR 

BRANCH 

IF 

LOWER ISAR=7 

8F 

2 

BNO 

ADDR 

BRANCH 

IF 

NO OVERFLOW 

98 

2 

BF 

T, ADDR 

CONDITIONAL BRANCH FALSE 

90+T 

*7 


ADDR MUST BE AN ADDRESS WITHIN -128 AND +127 LOCATIONS 
FROM THE SECOND BYTE OF THE BRANCH INSTRUCTION. 

T REPRESENTS A COMBINATION OF TYPE BITS: 

1- SIGN 

2- CARRY 
4-ZERO 

8-OVERFLOW (FALSE CONDITION CHECK ONLY. ) 
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INPUT/OUTPUT INSTRUCTIONS: 


INSTRUCTION MEANING HEX CODE BYTES 


IN PORTS INPUT LONG ADDRESS 

INS P0RT4 INPUT SHORT ADRESS 

OUT PORTS OUTPUT LONG ADDRESS- 

OUTS P0RT4 OTPUT SHORT ADDRESS 


PORTS REPRESENTS A PORT ADDRESS FROM 4 TO OFF. 
P0RT4 REPRESENTS A PORT ADDRESS FROM 0 TO OF. 


26 2 

A0+P0RT4 1 
27 2 

B0+P0RT4 1 



MISCELLANEOUS INSTRUCTIONS: 



INSTRUCTION 

MEANING 

HEX CODE 

BYTES 

DI 

DISABLE INTERRUPT 

1A 

1 

El 

ENABLE INTERRUPT 

IB 

1 

NOP 

NO OPERATION 

2B 

1 









APPENDIX A - RUN-TIME OPTIONS. 
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#**####*##**#*#*###*#**#**#***##**#########■* 


/B 

/E 

/F 

/H 

/J 


/K 

/L 

/N 

/O 

/P 

/S 

/T 

/W 

/O TO /9 


- OUTPUT BINARY FILE IN BNF'F FORMAT. 

- INHIBIT ERROR MESSAGES TO CONSOLE. 

- OUTPUT BINARY FILE IN FAIR-BUG FORMAT. 

- INHIBIT HEADINGS AND PAGINATION. 

- LIST UNASSEMBLED STATEMENTS AND CONDITIONAL 
ASSEMBLY PSEUDO-OPS. 

- EXPAND SYMBOL TABLE STORAGE INTO ADDITIONAL 
CORE. 

- OUTPUT LEADER (NULLS) IN BINARY FILE FOR EACH 
. ORG STATEMENT. 

- LIST ONLY THE SYMBOL TABLE. 

- OUTPUT LISTING IN OCTAL FORMAT INSTEAD OF IN 
HEXADECIMAL. 

- INCLUDE NORMALLY UNLISTED PSEUDO-OPS IN THE 
LISTING. 

- OMIT THE SYMBOL TABLE FROM THE LISTING. 

- REPLACE THE FORM/FEED WITH 3 CR/LF'S. 

- INHIBIT WARNING MESSAGES. 

- USER FLAGS# USED WITH THE ? OPERATOR. 




APPENDIX B - INDICATOR SET. 




# 

/ 

S: 

I 

•f 

•''C 

■'•D 

•'•0 

••"L 


" S M 


-•T 

} 

" OR 


- MULTIPLICATION. 

- DIVISION. 

- BOOLEAN AND. 

- INCLUSIVE OR. 

- ADDITION. 

- SUBTRACTION. 

- COMPLEMENT INDICATOR# (IJPARROW B). 

- BINARY RADIX INDICATOR# (IJPARROW B). 

- DECIMAL RADIX INDICATOR# (IJPARROW D). 

- HEXADECIMAL RADIX INDICATOR# (IJPARROW H). 

- OCTAL RADIX INDICATOR, (IJPARROW 0). 

- LEAST SIGNIFICANT BYTE ACCESS OPERATOR, 
(IJPARROW L). 

- MOST SIGNIFICANT BYTE ACCESS OPERATOR# 
(IJPARROW M). 

- TIMER COUNT OPERATOR# (IJPARROW T). 

- COMMENT INDICATOR. 

- ASCII CHARACTER INDICATOR. 

- USER FLAG OPERATOR. 

- CURRENT LOCATION COUNTER# (PERIOD). 





APPENDIX C 


PSEUDO-OPS. 


#14. 0. 0 




. ADDR 
. BIN 
. BYTE 
. DBYTE 
. DECM 
. DINST 
. END 
. ENDC 
. EQU 
. HEX 
. IFDEF 
. IFNDEF 
. IFNZRO 

ifzero 

. LIST 
. OCT 
. ORG 
. PAGE 
. SET 
. TITLE 
. ZERO 


- DOUBLE BYTE DATA STORAGE, REVERSED FORMAT. 

- CHANGES DEFAULT RADIX TO BINARY. 

- SINGLE BYTE DATA STORAGE. 

- DOUBLE BYTE DATA STORAGE. 

- CHANGES DEFAULT RADIX TO DECIMAL. 

- RENAMES A MICRGPROCESOR INSTRUCTION. 

- PROGRAM TERMINATOR. 

- ENDS CONDITIONAL ASSEMBLY. 

- ASSIGNS A PERMANENT VALUE TO A SYMBOL. 

- CHANGES DEFAULT RADIX TO HEXADECIMAL. 

- INCLUDE CODE TO . ENDC IF SYMBOL IS DEFINED. 

- INCLUDE CODE TO . ENDC IF SYMBOL IS NOT DEFINED. 

- INCLUDE CODE TO . ENDC IF OPERAND DOES NOT EQUAL 0. 

- INCLUDE CODE TO . ENDC IF OPERAND EQUALS 0. 

- PROVIDES SELECTIVE LISTINGS. 

- CHANGES DEFAULT RADIX TO OCTAL. 

- REASSIGNS THE CURRENT LOCATION COUNTER. 

- BEGINS NEW PAGE IN LISTING. 

- ASSIGNS A TEMPORARY VALUE TO A SYMBOL. 

- SPECIFIES HEADING. 

- ZEROS A SPECIFED NUMBER OF BYTES. 





APPENDIX D - ERROR MESSAGES. 
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*****#**#*#***####***■***•*#■##•#•*##*■**##***#**#•* ■#•*#****#■#****#**•«■ 


E: BN 
E: BR 
E: DF 
E: DR 
E: IL 
E: 10 
E: LO 
E: LS 
E: LT 
E: ML 
E : MO 
E: OC 
E: OE 
E: OM 
E: OS 
E: PE 
E: PS 
E : RE 
E: RV 
E: ST 
E: TL 
E: US 
E: WE 


- BAD NESTING OF BRACKETS. 

- BRANCH ADDRESS OUT OF RANGE. 

- OUTPUT DEVICE FULL. (FATAL) 

- DIGIT OUTSIDE OF RADIX. 

- ILLEGAL LABEL FIELD. 

- ILLEGAL OPERAND VALUE. 

-LINE INPUT OVERFLOW. 

- LOCAL SYMBOL SYNTAX ERROR. 

- LOCAL SYMBOL TABLE OVERFLOW. (FATAL) 

- MULTIPLE LABEL DEFINITION. 

- MISSING OR ILLEGAL MNEMONIC IN OPERATOR FIELD. 

- OPERAND TOO COMPLEX. 

- OPEN ERROR IN OUTPUT FILE. (FATAL) 

- OPERAND MISSING. 

- OPERAND SYNTAX ERROR. 

- PHASE ERROR) ADDRESS CONFLICT. (FATAL) 

- ILLEGAL PERMANENT SYMBOL USAGE IN OPERAND. 

- INPUT FILE READ ERROR. (FATAL) 

- BAD REGISTER VALUE FIELD. 

- SYMBOL TABLE OVERFLOW. (FATAL) 

- LABEL DEFINED TOO LATE. 

- UNDEFINED SYMBOL. 

- OUTPUT FILE WRITE ERROR. (FATAL) 


W:EF - NO . END STATEMENT IN LAST FILE. 

W:UC - UNINHIBITED CONDITIONAL ASSEMBLY IN EFFECT 

AT ASSEMBLY END. 


#**#*#*###**#**###**#*##*####*###**##*##•* •IS'*-**#-*###*#*'**#*#**#*- 



